Home > Language Reference > User Dialog Functions > CallDialog

CallDialog

The CallDialog function displays a dialog box defined previously.

Usage

Used to display a dialog box at a certain point of the script and the user can input data required for the next steps.

Syntax

CallDialog <dialog_name>[,<dialog_title>]

Parameters

<dialog_name>, label of the dialog box defined previously by BeginDialog function. The label cannot be a variable. 

<dialog_title>, optional, string, dialog box title (if specified, it replaces the title defined by the CAPTION statement in the BEGINDIALOG function). 

See also

BeginDialog

Example

BEGINDIALOG Dialog1 225, 176, 240, 189
        CAPTION "Title by Caption"
        TEXT "Message Text", 33, 26
        DEFPUSHBUTTON "&OK", btnok, 24, 115, 59, 22
ENDDIALOG

'At the line in the script where Dialog1 must be displayed, use CallDialog function
    CallDialog Dialog1
    'Or changing the dialog title 
    CallDialog Dialog1, "New title when called"