Start_MDIChild (OI 9.x) function
Description
Executes MDI child windows.
Syntax
mdichildID = Start_MDIChild(mdichildgroupID, mdiframeID, createparam, mdichildinstanceID, mdichildtitle, initialappearancemode [, initx, inity, winStruct])
Parameters
The MDIChild function has the following parameters.
| Parameter | Description |
|---|---|
| MdichildgroupID | The child window name. |
| MdiframeID | The frame window name. (The frame must already exist.) |
| Createparam | The createparam passed to the CREATE event. |
| MdichildinstanceID | The child instance ID. If a null string, the instance ID will be created automatically. |
| Mdichildtitle | The title to appear in the child window's title bar. |
| Initialappearancemode | 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) |
| WinStruct | The structure of a window as returned from 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
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.