Custom dialogue boxes

There are 5 steps in the life of a custom dialog box:

1.

The initialization by a call of the Dialog:Create function.

2.

The creation of the input/output fields.

3.

The management by one or more calls of Dialog:Run function.

4.

The reading of the output fields

5.

The closing by a call of the Dialog:Close function.

 
The steps 1, 3 and 5 are performed by the following functions:

  $\blacktriangleright$ Dialog:Create(NAME,TITLE,BUTTONS)

 
This function creates a new dialogue box.

• FOO (input) is not used
• NAME (input STRING) is the dialog's name.
• TITLE (input STRING) is the dialog window's title.
• BUTTONS (input STRINGLIST) is the list of the exit button's labels.
• The function return a dialog box identifier (return INT).

  $\blacktriangleright$ Dialog:Run( WIN)

 
This function manages a dialog box until one of the exit buttons is pressed. The dialog box is not removed from the view.

• FOO (input) is not used
• WIN (input INT) is the dialog box identifier.

  $\blacktriangleright$ Dialog:Close(WIN)

 
This function remove a dialog box from the view.

• FOO (input) is not used
• WIN (input INT) is the dialog box identifier.