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.

ParameterDescription
MdichildgroupIDThe child window name.
MdiframeIDThe frame window name. (The frame must already exist.)
CreateparamThe createparam passed to the CREATE event.
MdichildinstanceIDThe child instance ID. If a null string, the instance ID will be created automatically.
MdichildtitleThe title to appear in the child window's title bar.
Initialappearancemode

Window display.

ValueDescription
0Displays the window in the same way as the currently active child window. (Default)
1Normal.
2Minimized.
3Maximized.
InitXThe initial x position of a window. (optional)
InitYThe initial y position of a window. (optional)
WinStructThe 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.

  • No labels