[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.


Version 3.2 Generated 2024-02-25 Home