CHILD Mnemonic - Create a Child Window

Syntax

'CHILD'(id,x,y,w,h,title,flags,context{,eventmask})

Description

The 'CHILD' mnemonic creates a child window. It must be issued in the context of the window that is to contain it.

Note that for child windows, scroll bars will never appear. The size of the window is always the last size given to it programmatically (using the 'size' mnemonic or resbuilder).

Parameter

Description

id

Control ID number. It must be an integer between 1 and 32767 and be unique within a given top-level window.

x

Horizontal position of the upper-left corner of the control in current units.

y

Vertical position of the upper-left corner of the control in current units.

w

Width of the control in current units.

h

Height of the control in current units.

flags

Control flags, as follows:

 

Flag 

Description

 

$00000004$ 

Causes a horizontal scroll bar to appear whenever the window is resized to be smaller than its initial size and 'TRACK'(0) is specified.

 

$00000008$ 

Causes a vertical scroll bar to appear whenever the window is resized to be smaller than its initial size and 'TRACK'(0) is specified.

 

$00000010$ 

Sets the child window to be initially invisible.

 

$00000020$ 

Sets the child window to be initially disabled.

 

$00000800$ 

Creates a child window without a border.

 

$00010000$ 

Activates keyboard navigation in the child window. If this flag is specified, key pressed ("t") events for arrow keys and the tab key will not be reported.

 

$00100000$ 

Automatically arranges all controls to fit within the child window.

 

$00200000$ 

Attaches the child window to one side of the parent frame, by default to the top frame. It will always occupy the full extent of the parent window's edge (even if the parent is resized later), but the other dimension is determined by the width or height specified when the child was created. By default, docked child windows are attached to the top of their parent. This can be changed with the 'DOCK' mnemonic.

 

$00800000$ 

Sets the Enter key to behave as a Tab key.

 

$01000000$ 

Draws a recessed client edge around the child window.

 

$02000000$ 

Draws a raised edge around the child window.

context

An empty context for the child window to occupy. The child can then be referenced either by its ID number from within the parent context or by the ID 0 from its own context. Either method can be used in most cases.

eventmask

Event mask to be applied to the child window. For additional information, see SYSGUI Event Queue.

See Also

Mnemonics - Alphabetical Listing

Mnemonics - Group Listing