(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 within the DCL file named dcl-id. The string dialog 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 Bricscad window.

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

Examples

Code	Returns
(new_dialog "basicdcl" "sampler" "insert" '(1 2))	T
(new_dialog "basicdcl" "sampler" " " '(-1 -1))	T

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

load_dialog
new_dialog
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)
start_dialog

Tell me about...

(unload_dialog dcl_id)

LISP Compatibility

Programming Overview of LISP (LISt Processing) Language