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


 
==== 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|Create_Dialog()]], [[end_dialog|End_Dialog]], [[get_dialog_info|Get_Dialog_Info()]], [[set_dialog_info|Set_Dialog_Info()]], [[placedialog|PlaceDialog()]], [[start_window|Start_Window()]], [[end_window|End_Window()]], [[start_mdichild|Start_MDIChild()]]
 
==== Example ====
 
<code>
Parent = @window

returnValues = Dialog_Box("APP_LOGIN", Parent, @username)
</code>