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.
InstanceID = Start_MDIChild( WindowID,
FrameID,
CreateParam,
Reserved,
Title,
AppearanceMode,
InitX,
InitY,
InitWinStruct )
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. |
| 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() with "GetStructureFlag" set. |
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.
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.