Description
Starts a new window (specified in dialogID) which becomes an owned window of the owner window (specified in parentID).
Returns the name of the dialog box that has been started.
Syntax
dialogname = Create_Dialog (dialogID, parentID, mode, initparam)
Parameters
The Create_Dialog function has the following parameters.
| Parameter | Description |
|---|---|
| DialogID | Specify a valid window identifier for the new dialog box. The window definition must exist in the repository. |
| ParentID | If a valid parent, the new dialog box is owned by the parentID window, and the dialog box is modal. If invalid, Create_Dialog returns without creating the dialog box. The owner should not be an MDI child; in this case, pass the MDI frame as the owner. |
| mode | Pass true to create a modeless dialog box, where the owner window is still enabled. Pass false to disable the owner, and to make the dialog box modal. This parameter is optional and defaults to false. |
| initparam | This parameter is passed to the CREATE event of the dialog as the CreateParam. |
Note: Use End_Dialog to stop execution of this window, before closing the owner window.
See also
Dialog_Box(), End_Dialog, Start_Window(), End_Window(), Start_MDIChild()
