Description
This function is used to create a modal dialog box. It processes an event loop, as long as the dialog box exists, then returns any result to the calling procedure.
Syntax
return value = Dialog_Box(dialogID, parentID, initparam)
Parameters
The Dialog_Box function has the following parameters.
| Parameter | Description |
|---|---|
| DialogID | The name of the form to open as a dialog box. |
| ParentID | If valid, the new dialog box is owned by the specified parent. If parentID is null or invalid, Dialog_Box() returns without opening the form. |
| Initparam | This parameter is passed into the CREATE event of the form. |
Remarks
A window created using the Dialog_Box function should be closed using the End_Dialog function.
See also
Create_Dialog(), End_Dialog, Get_Dialog_Info(), Set_Dialog_Info(), PlaceDialog(), Start_Window(), End_Window(), Start_MDIChild()
Example
Parent = @window
returnValues = Dialog_Box("APP_LOGIN", Parent, @username)
