Start_MDIChild function [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Start_MDIChild function ======


 
==== Description ====
 
 
Executes a specified OpenInsight window (form) as an "MDI Child" window.  MDI Child windows must have an MDI frame as a parent and appears in the frame's MDI Client Area at runtime.
 
 
 
 
==== Syntax ====
 
<code>
InstanceID = Start_MDIChild( WindowID,
                                FrameID,
                                CreateParam,
                                Reserved,
                                Title,
                                AppearanceMode,
                                InitX,
                                InitY,
                                InitWinStruct )
</code>

==== Parameters ====
 
The MDIChild function has the following parameters.

^Parameter^Description^
|//windowID//|The child window name.|
|//FrameID//|The frame window name. (The frame must already exist.)|
|//Createparam//|The //createparam// passed to the [[create_event|CREATE event]].|
|//Reserved//|Pass in the null string ("").|
|//Title//|The title to appear in the child window's title bar.|
|//Appearancemode//|Window display.\\ \\ __Value__ - __Description__\\ 0 - Displays the window in the same way as the currently active child window. (Default)\\ 1 - Normal.\\ 2 - Minimized.\\ 3 - Maximized.|
|//InitX//|The initial //x// position of a window. (optional)|
|//InitY//|The initial //y// position of a window. (optional)|
|//InitWinStruct//|The structure of a window as returned from [[start_window|Start_Window()]] with "GetStructureFlag" set.|


==== Returns ====

The return value is the fully qualified name of the MDI child if the child window was created successfully. Otherwise a null string is returned. Typically, the full name has the format\\ \\ MDIChildGroupID :  '*' :  MDIChildInstanceID.

 
==== See Also ====
 
[[end_window|End_Window()]], [[start_window|Start_Window()]], [[dialog_box|Dialog_Box()]], [[create_dialog|Create_Dialog()]]
 
==== Remarks ====
 
To execute the child window called CHILD_WIN in the frame window FRAME_WIN, the call to Start_MDIChild would be:

MDIChildID = Start_MDIChild("CHILD_WIN", "FRAME_WIN", "", "", "My Child Window", 1)

The return value, if the function was successful, would return child_win*1 which is the child name concatenated with the instance ID.