====== Create_Dialog function (OI 9.x) ======


 
==== 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|End_Dialog]] to stop execution of this window, before closing the owner window.|

 
==== See Also ====
 
[[dialog_box|Dialog_Box()]], [[end_dialog|End_Dialog]], [[start_window|Start_Window()]], [[end_window|End_Window()]], [[start_mdichild|Start_MDIChild()]]
 
**
**