Differences between multi-page controls: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | [](</File:PageControlsComparison.png>) | |
| 2 | 2 | ||
| 3 | 3 | [](</File:PageControlsComparison.png> "Enlarge") | |
| 4 | 4 | ||
| 5 | 5 | Example renderings of TPageControl and TTabControl with a TNotebook as a child control. TMemos added as examples (set to borderstyle bsNone, align alClient, font size 14). | |
| 6 | 6 | ||
| 7 | 7 | [](</File:PageControlsComparison2.png>) | |
| 8 | 8 | ||
| 9 | 9 | [](</File:PageControlsComparison2.png> "Enlarge") | |
| 10 | 10 | ||
| 11 | 11 | To emphasize the differences in outline rendering the TMemos have been shrunken in size. Also TPageControl tabs now have glyphs while the TTabControl does not support them. | |
| 12 | 12 | ||
| 13 | 13 | [](</File:Structure1.png>) | |
| 14 | 14 | ||
| 15 | 15 | [](</File:Structure1.png> "Enlarge") | |
| 16 | 16 | ||
| 17 | 17 | Structure for the examples used. Note how TNotebook has only one content page (but could provide more) while the TTabControl has four tab buttons (independent controls). TPageControl has one TTabSheet for each page with the content being on the second one in this example. | |
| 18 | 18 | ||
| 19 | 19 | Lazarus (as of version 3.6 at time of writing) provides [[TPageControl]] and separate [[TTabControl]] and [[TNotebook]] controls for multi-page use cases (as Delphi also does). | |
| 20 | 20 | ||
| 21 | 21 | However, even though TNotebook and TTabControl can mimic the behavior and appearance of a TPageControl, there are differences between the controls, which this article will highlight upon. | |
| 22 | 22 | ||
| 23 | 23 | Additionally there are the TExtendedNotebook and TExtendedTabControl on the [[LazControls]] tab, which will be handled in a separate section below. | |
| 24 | 24 | ||
| 25 | 25 | _TPageControl_ | |
| 26 | 26 | ||
| 27 | 27 | * [](</File:TTabControl-Inspector.png> "TTabControl") | |
| 28 | 28 | ||
| 29 | 29 | _TTabControl_ | |
| 30 | 30 | ||
| 31 | 31 | * [](</File:TTabSheet-Inspector.png> "TabSheet of TPageControl") | |
| 32 | 32 | ||
| 33 | 33 | _TabSheet of TPageControl_ | |
| 34 | 34 | ||
| 35 | 35 | * [](</File:TNotebook-Inspector.png> "TNotebook") | |
| 36 | 36 | ||
| 37 | 37 | _TNotebook_ | |
| 38 | 38 | ||
| 39 | 39 | * [](</File:TPage-Inspector.png> "TPage of TNotebook") | |
| 40 | 40 | ||
| 41 | 41 | _TPage of TNotebook_ | |
| 42 | 42 | ||
| 43 | 43 | ## Specialised controls | |
| 44 | 44 | ||
| 45 | 45 | Lazarus additionally provides the components [TExtendedNotebook](</index.php?title=TExtendedNotebook&action=edit&redlink=1> "TExtendedNotebook \(page does not exist\)") and [TExtendedTabControl](</index.php?title=TExtendedTabControl&action=edit&redlink=1> "TExtendedTabControl \(page does not exist\)") in the [[LazControls]] tab. They are used in the Lazarus IDE itself, but are also available for own projects this way. | |
| 46 | 46 | ||
| 47 | 47 | The main difference for the TExtendedTabControl is that it provides a wrapper for a TToolbar which is displayed right aligned on the tab header level. | |
| 48 | 48 | ||
| 49 | 49 | The TExtendedNotebook however provides an integrated tab header again. In fact making it the same as a TPageControl. It even exposes TTabSheets and not TPage subpage elements. And also renders exactly like a TPageControl with visible borders around the subpages. | |
| 50 | 50 | ||
| 51 | 51 | ## Workaround (as of Lazarus 3.6) | |
| 52 | 52 | ||
| 53 | 53 | To have a consistent and clean rendering of the outline frame - or more precise: having no visible outline around the TPageControl - a TNotebook seems to be the way to go. To also have icons in the tab header, you cannot use a TTabControl though - but, you can "misuse" a TPageControl for that. In fact you have to resize the TPageControl in a way that just the header section is visible. Below that you place a TNotebook. Maybe combine both in a TPanel to make things easier. After that you can setup the icons to be used in the TPageControl and you need to add code that reacts on tab changes in the TPageControl and consequently activates the right page in the TNotebook. | |
| 54 | 54 | ||
| 55 | 55 | --- | |
| 56 | - | ||
| 56 | + | *From the Free Pascal wiki, page "Differences between multi-page controls", as the Internet Archive kept it on 2026-01-15, last changed on 2024-11-09. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |