load_dialog

• short description:
• load a dcl file
• sample call:
• (load_dialog "mydialogs.dcl")
• function signature:
• • number of arguments:
  • 1
  • argument 1:
  • path to dcl-file, present in support path
  • return value:
  • file-id, an integer identifier representing the loaded dcl file
• description:
• This function loads and parses a dcl file. A parsed instance of that dcl file is stored and an id is assigned to it. The id is needed to build new dialogs from the parsed instance. The id will remain valid until it is unloaded or until the entire CAD application is terminated. The dcl terminology for the id of a parsed instance is file-id. This naming is somewhat misleading since a file is only needed at load-time. After being loaded, the dcl file is no longer needed. The dcl file can even be destroyed safely. Indeed, it is a valid but uncommon practice for a lisp program to build its own dcl file, load it, destroy the file, then use the file-id. Also, multiple parsed instances can exist for the same dcl-file.