Tab Controls

The following lists the mandatory properties for tab controls:

Tabcontrol control-id"title"x y width height

Property

Description

tabcontrol

Identifies the control as a tab control.

control-id

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

"title"

Title of the control, contained in quotation marks.

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.

width

Width of the control in current units.

height

Height of the control in current units.

The following identifies the optional properties for this control.

Display Tabs as Buttons (buttons)

Draw Client Edge (clientedge)

Initially Disabled (disabled)

Set Fixed Tab Widths (fixedwidths)

Prevent Focus (focusnever)

Receive Focus on Button Down (focusonbuttondown)

Set Control Font (font)

Force Icons to Left Margin (forceiconleft)

Force Labels to Left Edge of Tabs (forcelabelleft)

Group Controls Together (group)

Set Additional Horizontal Spacing Between Tabs (horizontalpadding)

Define Image List (imagelist)

Set Initial Tab (initialtab)

Initially Invisible (invisible)

Set Status Bar Text (longcue)

Display all Tab Row (multiline)

Set Name (name)

Prevent Automatic Management of Tab Item Display and Sizing (noautomanagement)

Prevent Full Tab Justification (raggedright)

Draw Raised Edge (raisededge)

Set Full Tab Justification (rightjustify)

Share Image Lists with Other Tab Controls (shareimagelists)

Set Tool Tip Text (shortcue)

Set Tab Height (tabheight)

Display Tabs as Tabs/Draw Border Around Display (tabs)

Set Tab Width (tabwidth)

Create as Tool Button Window (toolwindow)

Set Additional Vertical Tab Spacing (verticalpadding).

Automanagement

Backgroundcolor

Foregroundcolor

Group

Height

Initialcontents

Opaque

Padding

Popupmenuid

Singleline

Title

Width

Defining Tabs

The following lists the mandatory properties for tabs contained within tab controls:

Tab "title"imagelist-indexchildwindow|control-id

The following describes the tab properties:

Property

Description

Tab

Identifies the control as a tab.

"title"

Title of the tab, contained in quotation marks.

imagelist-index

Integer that represents the index value of an image list.

childwindow-id|control-id

ID of the child window or control.

Attributes and flags used in child window definitions can also be used in tab definitions.

Example

The following example contains a window with two tab controls; the first contains only the mandatory definitions, and the second contains optional settings. The second tab control contains three tabs:

Version "3.0"

Window 1 "Control Window" 0 0 400 300

Begin

Tabcontrol 1 "Tab Control 1" 10 225 100 50

Tabcontrol 2 "Tab Control 2" 50 10 300 200

Begin

Backgroundcolor Rgb(128,128,128)

Initialtab 0

Width 400

Height 200

Verticalpadding 15

Horizontalpadding 15

Imagelist "\\foo.bmp"

Automanagement

Buttons Fixedwidth Focusnever

Focusonbuttondown Forceiconleft Multiline

Raggedright Rightjustify

Singleline Clientedge Raisededge

Tab "Tab 1" 0 1000

Tab "Tab 2" 1 2000

Tab "Tab 3" 2 3000

End

End

Child-window 1000 100 100

Begin

Button 1 "OK" 10 10 50 25

End

Child-window 2000 100 100

Begin

Button 1 "Yes" 10 10 50 25

End

Child-window 3000 100 100

Begin

Button 1 "Finish" 10 10 50 25

End