(new_dialog dialog dcl-id [function point])

Display a dialog box.

This is the function you use to display a dialog box. The dialog box is identified by dialog name and the DCL file represented by the handle dcl-id. The handle is obtained from the load_dialog function.

The new_dialog function optionally executes the LISP routine named function. To ignore this argument, use " "; you have to use the " " when you want to specify the point coordinates but not execute a function.

The optional point argument specifies the x,y coordinates of the upper-left corner. When point consists of negative coordinates, such as '(-1 -1), the dialog box appears at the default location, which is usually the center of the progeCAD window.

When the new_dialog function is successful, it returns T; otherwise, it returns nil.

Example

NOTE The order of calling a dialog box is as follows:

1. load_dialog
2. new_dialog
3. action_tile, start_image, start_list, etc (perform all dialog box initialization, such as associating an action with a tiles, creating an image, and making the lists for list boxes)
4. start_dialog

Tell me about...

(unload_dialog dcl_id)

LISP Compatibility

Programming Overview of LISP (LISt Processing) Language