Vcl.ComCtrls.TPageControl.FindNextPage
Delphi
function FindNextPage(CurPage: TTabSheet;
GoForward, CheckTabVisible: Boolean; CheckTabEnabled: Boolean = False): TTabSheet;
C++
TTabSheet* __fastcall FindNextPage(TTabSheet* CurPage, bool GoForward, bool CheckTabVisible, bool CheckTabEnabled = false);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | Vcl.ComCtrls.pas Vcl.ComCtrls.hpp |
Vcl.ComCtrls | TPageControl |
Description
Returns the next page in the page control before or after a specified page.
Call FindNextPage to locate a page in the page control by its position relative to the page specified by the CurPage parameter.
If the GoForward parameter is True, FindNextPage returns the next page in the page control after CurPage. If GoForward is False, FindNextPage returns the previous page.
If CurPage is not a page in the page control, FindNextPage returns the first page when GoForward is True or the last page when GoForward is False.
If GoForward is True and CurPage is the last page in the page control, FindNextPage returns the first page. If GoForward is False and CurPage is the first page in the page control, FindNextPage returns the last page.
|
GoForward |
CurPage |
FindNextPage returns |
|---|---|---|
|
|
It is a page in the page control |
The next page in the page control after |
|
|
It is a page in the page control |
The previous page in the page control before |
|
|
It is not a page in the page control or is the last one |
The first page in the page control |
|
|
It is not a page in the page control or is the first one |
The last page in the page control |
When CheckTabVisible is True, FindNextPage returns the next page with a TabVisible property set to True. If CheckTabVisible is False, FindNextPage returns the next page, including pages with TabVisible set to False.
Finally, if CheckTabEnabled parameter is True, disabled pages are skipped. If it is False, disabled pages are not skipped.
See Also
- Vcl.ComCtrls.TPageControl.Pages
- Vcl.ComCtrls.TPageControl.SelectNextPage
- Vcl.ComCtrls.TTabSheet.TabVisible
Code Examples