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.

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.

End_Window(), Start_Window(), Dialog_Box(), Create_Dialog()

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.