MsgPlus::CreateChildWnd

The MsgPlus::CreateChildWnd function creates a child window for an existing interface window. It can be used to create wizards or any other kind of more complex windows.

Syntax

[object] CreateChildWnd(
    [object] Parent,
    [string] XmlFile,
    [string] WindowId,
    [number] PosX,
    [number] PosY,
    [boolean,optional] Visible
);

Parameters

Parent

[object] Existing PlusWnd object previously created with CreateWnd.

XmlFile

[string] Path to the Interface XML file. This is where the entire window is defined. The path is relative to the script's directory by default, to override this behavior, prefix the path with "\". Example: "\C:\directory\windows.xml".

WindowId

[string] Unique identifier of the window to create. A window with the same identifier has to be found in the XML file for the function to succeed.

PosX

[number] Horizontal position of the child window in the parent, in pixels.

PosY

[number] Vertical position of the child window in the parent, in pixels.

Visible

[boolean,optional] Specifies if the window is to be shown automatically after creation (default) or not.

Return Value

A PlusWnd object that you can use to control every aspect of the new child window. If the window cannot be created, the return value is null.

This function typically fails for the following reason:

• The specified XML interface file is not valid.

Remarks

This function is to be used by advanced users, used to creating interface windows with CreateWnd.

Function Information

See Also

MsgPlus Object, CreateWnd.