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.
| ||||||||||
| 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. |
Return value
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(), Start_Window(), Dialog_Box(), 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.
