new_dialog

(new_dialog dialog_name dialog_id [default_action [position]])

The new_dialog function displays a DCL dialog box if the dialog box definition has been loaded successfully with the load_dialog function.

Arguments

dialog_name: String supplying the unique name of the dialog box.

dialog_id: Handle of the DCL file that contains the description of the dialog box.

default_action: Optional string containing a Lisp expression being evaluated, if a dialog box tile is clicked for which no action function has been specified.

position: Optional 2D point that determines the screen coordinates for the upper left corner of the dialog box. Specifying -1,-1 forces the dialog to be displayed centered on the screen.

Return Value

If the function succeeds, it returns T; otherwise, it returns nil.

Examples

(new_dialog "dialog_1" dlg_id)

(new_dialog "dialog_1" dlg_id "(default_func)")

(new_dialog "dialog_1" dlg_id "(default_func)" '(0 0))

(new_dialog "dialog_1" dlg_id "" '(-1 -1))

Related Functions

load_dialog, start_dialog