[Overview][Constants][Types][Classes][Procedures and functions][Index] | Reference for unit 'ComCtrls' (#lcl)

# TCustomTabControl.ActivePage

Caption for the active page in the tabbed control.

## Declaration

Source position: comctrls.pp line 459

`protected property TCustomTabControl.ActivePage : string read GetActivePage write SetActivePage stored IsStoredActivePage;`

## Description

ActivePage is a String property which holds the caption for the active page in the control.

The property value is retrieved using values in the PageIndex and Page properties, and contains the Caption property for the TCustomPage instance. The property value is an empty string ('') if PageIndex is not in the range 0..PageCount-1.

Setting a new value for the property causes the indexed Page property to be searched to locate the TCustomPage instance with a Caption matching Value. If a page is found with the specified caption, the SetPageIndex method is called to validate and store the PageIndex, and signal the OnChange event handler when configured in Options. No actions are performed if the new property Value is not used in Page.

A value assigned to ActivePage at design-time is not stored in the LCL component streaming mechanism.

Use ActivePageComponent to read or write the TCustomPage instance that is the active page in the control.

Use Tabs to access the internal page (or tab) list for the control.

## See also

TCustomTabControl.Page |  | Provides indexed access to the page objects used on the tabbed control.
TCustomTabControl.PageIndex |  | Ordinal position for the selected page on the tabbed control.
TCustomTabControl.Options |  | The set of Options enabled for the tabbed control.
TCustomTabControl.OnChange |  | Event handler signalled when the active page (or tab) for the control is changed.
TCustomTabControl.ActivePageComponent |  | The active TCustomPage instance for the tabbed control.
TCustomTabControl.Tabs |  | Contains the list of pages accessible in the tabbed control.
TControl.Caption |  | The text displayed for the control.