TabStrip

Object List Hierarchy Next Object

Definition:

Use to create tabs resembling the dividers in a notebook, which give you the capability to define several pages for a window or dialog box.

Icon: images/Phx00218.gif

Specialized Features:

There are no added methods.

Properties Use to…

ClientLeft Return the coodinate reflecting the left edge of the TabStrip control's internal display area.

ClientTop Return the coordinate reflecting the topmost edge of the TabStrip control's internal display area.

ClientWidth Return the coordinate reflecting the width of the TabStrip control's display area.

ClientHeight Return the coordinate reflecting the height of the TabStrip control's internal display area.

ImageListRef Reference the ImageList object where icons for the tabs come from.

MultiRow Specify whether a TabStrip control can have multiple rows of tabs.

SelectedItem Reference the embedded TabStripTab object that is currently selected.

Style Determine whether to display the tabstrip as tabs or buttons.

TabWidthStyle Specifiy whether the tab width is justified, nonjustified,or fixed.

TabFixedHeight Indicate the fixed height of all tabs in the TabStrip control.

TabFixedWidth Indicate the fixed width of all tabs in the specified TabStrip control.

Event Use To

BeforeClick Perform an action before generating the click event when a TabStripTab object is clicked in a TabStrip control. It is typically used to save the information on the current tab before generating the click event to select a different tab, or it can be used to deny the Click event, thus preventing the Click event if the current page is not filled in correctly.

Click Perform an action when the user presses and releases a mouse button while on an object, or when the value of a control is changed in code.

GotFocus Define what occurs when an object is given the focus.

KeyDown Define what occurs when the user presses a key while an object has the focus.

KeyUp Define what occurs when the user releases a key while an object has the focus.

KeyPress Define what occurs when the user presses and releases an ANSI key.

LostFocus Define what occurs when an object loses the focus.

Copied Features:

images/Phx00219.gif Properties images/Phx00220.gif Methods images/Phx00221.gif Events

Details:

The control consists of single or multiple embedded TabStripTab objects. The appearance of each tab can be modified at any time using the available properties. The tabs can also be removed or added as needed.

The TabStrip control also contains properties that control its appearance. You can use the Style property to determine whether the TabStrip control will resemble notebook-like tabs or pushbuttons. The notebook-like tabs appear with a three-dimensional border, the push-buttons do not. When a TabStrip is first placed on a form, it has one notebook tab by default.

You can also resize the TabStrip control by dragging its edges or using its size and location properties ( Top, Left, Height, and Width) properties. If you want to allow your control to have multiple rows of tabs, set the MultiRow property. You can specify the justification of each row using the TabWidthStyle property , then use the TabFixedHeight and TabFixedWidth properties to manage the height and width for all tabs in the TabStrip control.

The TabStrip control is not a container. Generally, you will embed HyperForms on your form and associate each TabStripTab Click event showing one of these Forms fit to the Client area of the TabStrip.

The SelectedItem property of the TabStrip control is the reference to the TabStripTab object, which has properties that determine the appearance of individual tabs.