A set of folder-style (trapezoidal) bottom-tabs.

Syntax

[<oRef> =] new TabBox(<container> [,<name expC>])

<oRef>

A variable or property—typically of <container>—in which to store a reference to the newly created TabBox object.

<container>

The container—typically a Form object—to which you’re binding the TabBox object.

<name expC>

An optional name for the TabBox object. If not specified, the TabBox class will auto-generate a name for the object.

Properties

The following tables list the properties and events of interest in the TabBox class. (No particular methods are associated with this class.)

Property

Default

Description

anchor

1 – Bottom

How the TabBox object is anchored in its container (0=None, 1=Bottom)

baseClassName

TABBOX

Identifies the object as an instance of the TabBox class

className

(TABBOX)

Identifies the object as an instance of a custom class. When no custom class exists, defaults to baseClassName

colorHighlight

BtnText/BtnFace

The color of the selected tab

colorNormal

BtnFace

The color of the background behind the tabs

curSel

 

The number of the currently selected tab

dataSource

 

The tab names

 

Event

Parameters

Description

onSelChange

 

After a different tab is selected

 

The following table lists the common properties, events, and methods of the TabBox class:

Property

 

Event

 

Method

before
dragEffect

enabled

fontBold

fontItalic

fontName

fontSize

fontStrikeout

fontUnderline

form

height

helpFile

helpId

hWnd

id
left

mousePointer

name

pageno

parent

printable

speedTip

statusMessage

systemTheme

tabStop

top

visible

width

beforeRelease
onClose

onDesignOpen

onDragBegin

onGotFocus

onHelp

onLeftDblClick

onLeftMouseDown

onLeftMouseUp

onLostFocus

onMiddleDblClick

onMiddleMouseDown
onMiddleMouseUp

onMouseMove

onOpen

onRightDblClick

onRightMouseDown

onRightMouseUp

when

drag( )
move( )

release( )

setFocus( )

Description

A TabBox contains a number of tabs that users can select.

By setting the pageno property of a TabBox control to zero (the default), you can implement a tabbed multi-page form where the user can easily switch pages by selecting tabs. Use the pageno property of a control to determine on which page the control appears, and use the curSel property and onSelChange event of the TabBox to switch between pages.