.topic ctrl.tabstrip
.title TabStrip
.toc 1 Tabbed and Split Controls
.toc 1 TabStrip
.index TabStrip
.index TabControl
.index SetActive

.h1 TabStrip

VB Equivalent: TabStrip -- DVX Widget: tabcontrol

A tabbed container. Each tab page is a separate container that holds child controls. Switching tabs shows one page and hides others.

.h2 Type-Specific Properties

.table
  Property   Type      Description
  --------   -------   -------------------------------------------
  TabIndex   Integer   Index of the active tab (0-based). Note: this property name collides with the common VB-compatibility TabIndex property, which shadows it at runtime. Use the SetActive method instead to switch tabs.
.endtable

.h2 Type-Specific Methods

.table
  Method                   Description
  ------                   -----------
  AddPage title$           Add a new tab page with the given title.
  GetActive()              Returns the index of the active tab.
  SetActive index%         Switch to the tab at the given index. This is the recommended way to change tabs at runtime (the TabIndex property is shadowed by the common property handler).
.endtable

Container: Yes

Default Event: Click

.note warning
The TabIndex property is shadowed by the common property handler at runtime. Use the SetActive method to change tabs programmatically.
.endnote

.link ctrl.common.props Common Properties, Events, and Methods