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


 
==== Description ====
 
Begins execution of an OpenInsight window (OIWINEXE). Optionally, returns an existing structure for modification before execution.
 
==== Syntax ====
 
//windowname// = **Start_Window** (//windowID//, //parentID//, //createparam//, //getstructureflag//, //instance//)
 
==== Parameters ====
 
The Start_Window function has the following parameters.

^Parameter^Description^
|//WindowID//|Name of window, as registered in the repository.|
|//ParentID//|Name of parent window, as a valid repository entry. If //parentID// has a value, then the window specified in //windowID// is executed as a window owned by //parentID//.\\ \\ An owned window has the following characteristics:\\ \\ ·  always on top of z-order (cannot be put behind its owner);\\ \\ ·  is automatically destroyed, when the owner is destroyed;\\ \\ ·  is hidden, when owner is minimized.|
|//createparam//|Any data you want to make available to the new window at [[create_event|CREATE event]]. This data cannot contain @RM (Char(255)) values.|
|//getstructureflag//|Pass true, to return the structure of a window, without actually executing it. You can modify the structure, before executing it. Use the [[create_service|CREATE message]] for the Utility function, to execute the structure returned by Start_Window().|
|//Instance//|Reserved for future use.|


**Note:**   Although the term "parent" is used, the window specified in //parentID// is actually the owner of the window to be executed.

 
==== Returns ====
 
Returns the window name. If //getstructureflag// was passed true, then the return value is the repository window structure.
 
==== See Also ====
 
[[end_window|End_Window()]], [[start_mdichild|Start_MDIChild()]], [[dialog_box|Dialog_Box()]], [[create_dialog|Create_Dialog()]], [[create_service|Utility("CREATE")]], [[orig_struct|ORIG_STRUCT property]], [[ps_equates|PS_EQUATES insert record]].