QStyleOptionTab Class
Die Klasse „QStyleOptionTab“ dient dazu, die Parameter für die Darstellung einer Registerleiste zu beschreiben. Mehr...
| Header: | #include <QStyleOptionTab> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QStyleOption |
Öffentliche Typen
| enum | CornerWidget { NoCornerWidgets, LeftCornerWidget, RightCornerWidget } |
| flags | CornerWidgets |
| enum | SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | TabFeature { None, HasFrame, MinimumSizeHint } |
| flags | TabFeatures |
| enum | TabPosition { Beginning, Middle, End, OnlyOneTab, Moving } |
Öffentliche Funktionen
| QStyleOptionTab() | |
| QStyleOptionTab(const QStyleOptionTab &other) | |
| QStyleOptionTab & | operator=(const QStyleOptionTab &) |
Öffentliche Variablen
| QStyleOptionTab::CornerWidgets | cornerWidgets |
| bool | documentMode |
| QIcon | icon |
| QSize | iconSize |
| QSize | leftButtonSize |
| QStyleOptionTab::TabPosition | position |
| QSize | rightButtonSize |
| int | row |
| QStyleOptionTab::SelectedPosition | selectedPosition |
| QTabBar::Shape | shape |
| int | tabIndex |
| QString | text |
Ausführliche Beschreibung
Die Klasse `QStyleOptionTab` wird zum Zeichnen mehrerer integrierter Qt Widgets verwendet, darunter ` QTabBar ` und das Panel für ` QTabWidget`.
Eine Instanz der Klasse `QStyleOptionTab` verfügt über die Eigenschaften ` type `, ` SO_Tab ` und ` version ` 3. Der Typ wird intern von ` QStyleOption`, dessen Unterklassen und ` qstyleoption_cast()` verwendet, um den Typ der Stiloption zu bestimmen. Im Allgemeinen müssen Sie sich darüber keine Gedanken machen, es sei denn, Sie möchten eine eigene Unterklasse von ` QStyleOption ` und eigene Stile erstellen. Die Version wird von Unterklassen von ` QStyleOption ` verwendet, um Erweiterungen zu implementieren, ohne die Kompatibilität zu beeinträchtigen. Wenn Sie ` qstyleoption_cast()` verwenden, müssen Sie dies normalerweise nicht überprüfen.
Aus Leistungsgründen gibt es nur wenige Mitgliedsfunktionen, und der Zugriff auf die Mitgliedsvariablen erfolgt direkt (d. h. über den Operator . oder -> ). Dadurch sind die Strukturen einfach zu verwenden, und es wird deutlich, dass es sich lediglich um Parameter handelt, die von den Stilfunktionen verwendet werden.
Siehe auch „ QStyleOption “.
Dokumentation zu Mitgliedstypen
enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets
Diese Markierungen kennzeichnen die Eck-Widgets in einer Registerkarte.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionTab::NoCornerWidgets | 0x00 | Es sind keine Eck-Widgets vorhanden |
QStyleOptionTab::LeftCornerWidget | 0x01 | Widget in der linken Ecke |
QStyleOptionTab::RightCornerWidget | 0x02 | Widget für die rechte Ecke |
Der Typ „CornerWidgets“ ist ein typedef für QFlags<CornerWidget>. Er speichert eine ODER-Kombination von CornerWidget-Werten.
Siehe auch „ cornerWidgets “.
enum QStyleOptionTab::SelectedPosition
Diese Enumeration beschreibt die Position der ausgewählten Registerkarte. Bei einigen Stilen muss eine Registerkarte unterschiedlich dargestellt werden, je nachdem, ob sie an die ausgewählte Registerkarte angrenzt oder nicht.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionTab::NotAdjacent | 0 | Die Registerkarte grenzt nicht an eine ausgewählte Registerkarte (oder ist selbst die ausgewählte Registerkarte). |
QStyleOptionTab::NextIsSelected | 1 | Die nächste Registerkarte (in der Regel die Registerkarte rechts) ist ausgewählt. |
QStyleOptionTab::PreviousIsSelected | 2 | Die vorherige Registerkarte (in der Regel die Registerkarte links) ist ausgewählt. |
Siehe auch „ selectedPosition “.
enum QStyleOptionTab::StyleOptionType
Diese Enumeration dient zur Speicherung von Informationen über den Typ der Stiloption und ist für jede Unterklasse von ` QStyleOption ` definiert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionTab::Type | SO_Tab | Der Typ der bereitgestellten Stiloption (SO_Tab für diese Klasse). |
Der Typ wird intern von ` QStyleOption`, seinen Unterklassen und ` qstyleoption_cast()` verwendet, um den Typ der Stiloption zu bestimmen. Im Allgemeinen müssen Sie sich darüber keine Gedanken machen, es sei denn, Sie möchten eine eigene Unterklasse von ` QStyleOption ` und eigene Stile erstellen.
Siehe auch StyleOptionVersion.
enum QStyleOptionTab::StyleOptionVersion
Diese Enumeration dient zur Speicherung von Informationen über die Version der Stiloption und ist für jede Unterklasse von ` QStyleOption ` definiert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionTab::Version | 1 | 3 |
Die Version wird von Unterklassen von ` QStyleOption ` verwendet, um Erweiterungen zu implementieren, ohne die Kompatibilität zu beeinträchtigen. Wenn Sie ` qstyleoption_cast()` verwenden, müssen Sie dies normalerweise nicht überprüfen.
Siehe auch ` StyleOptionType`.
enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures
Beschreibt die verschiedenen Funktionen, die eine Registerkarte haben kann.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionTab::None | 0x00 | Eine normale Registerkarte. |
QStyleOptionTab::HasFrame | 0x01 | Die Registerkarte befindet sich in einem Registerrahmen |
QStyleOptionTab::MinimumSizeHint (since Qt 6.9) | 0x02 | Die Mindestgröße der Registerkarte wird gemessen, im Gegensatz zu ihrer regulären Größe. |
Der Typ „TabFeatures“ ist ein typedef für QFlags<TabFeature>. Er speichert eine ODER-Kombination von TabFeature-Werten.
Siehe auch „ QStyleOptionToolBar::features “.
enum QStyleOptionTab::TabPosition
Diese Enumeration beschreibt die Position der Registerkarte.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionTab::Beginning | 0 | Die Registerkarte ist die erste Registerkarte in der Registerkartenleiste. |
QStyleOptionTab::Middle | 1 | Die Registerkarte ist weder die erste noch die letzte Registerkarte in der Registerkartenleiste. |
QStyleOptionTab::End | 2 | Die Registerkarte ist die letzte Registerkarte in der Registerkartenleiste. |
QStyleOptionTab::OnlyOneTab | 3 | Die Registerkarte ist sowohl die erste als auch die letzte Registerkarte in der Registerkartenleiste. |
QStyleOptionTab::Moving (since Qt 6.6) | 4 | Die Registerkarte wird per Mauszug oder durch eine Animation verschoben. |
Siehe auch „ position “.
Dokumentation zu Member-Funktionen
QStyleOptionTab::QStyleOptionTab()
Erstellt ein `QStyleOptionTab`-Objekt und initialisiert die Membervariablen mit ihren Standardwerten.
QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)
Erstellt eine Kopie der Stiloption „ other “.
[noexcept default] QStyleOptionTab &QStyleOptionTab::operator=(const QStyleOptionTab &)
other Weist dieser Instanz von „ QStyleOptionTab “ den Wert „ “ zu.
Dokumentation zu Member-Variablen
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
Diese Variable enthält eine ODER-Kombination aus den Werten „ CornerWidget “, die die Eck-Widgets der Tab-Leiste angeben
Der Standardwert ist „ NoCornerWidgets “.
Siehe auch „ CornerWidget “.
bool QStyleOptionTab::documentMode
Diese Variable gibt an, ob sich die Tabbar im Dokumentmodus befindet.
Der Standardwert ist „false“;
QIcon QStyleOptionTab::icon
Diese Variable enthält das Symbol für die Registerkarte
Der Standardwert ist ein leeres Symbol, d. h. ein Symbol, das weder über eine Pixmap noch über einen Dateinamen verfügt.
QSize QStyleOptionTab::iconSize
Diese Variable enthält die Größe der Symbole
Der Standardwert ist „ QSize “ (-1, -1), d. h. eine ungültige Größe; verwenden Sie „ QStyle::pixelMetric()“, um die Standardgröße für Symbole in Registerkartenleisten zu ermitteln.
Siehe auch QTabBar::iconSize().
QSize QStyleOptionTab::leftButtonSize
Diese Variable enthält die Größe des linken Widgets auf der Registerkarte.
Der Standardwert ist „ QSize “ (-1, -1), d. h. eine ungültige Größe;
QStyleOptionTab::TabPosition QStyleOptionTab::position
Diese Variable enthält die Position der Registerkarte in der Registerkartenleiste
Der Standardwert ist „ Beginning “, d. h., die Registerkarte ist die erste Registerkarte in der Registerkartenleiste.
QSize QStyleOptionTab::rightButtonSize
Diese Variable enthält die Größe für das rechte Widget auf der Registerkarte.
Der Standardwert ist „ QSize “ (-1, -1), d. h. eine ungültige Größe;
int QStyleOptionTab::row
Diese Variable gibt an, in welcher Zeile sich die Registerkarte derzeit befindet
Der Standardwert ist 0, was die vorderste Zeile angibt. Derzeit kann diese Eigenschaft nur den Wert 0 annehmen.
QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition
Diese Variable gibt die Position der ausgewählten Registerkarte im Verhältnis zu dieser Registerkarte an
Der Standardwert ist „ NotAdjacent “, d. h., die Registerkarte grenzt weder an eine ausgewählte Registerkarte an, noch ist sie selbst die ausgewählte Registerkarte.
QTabBar::Shape QStyleOptionTab::shape
Diese Variable enthält die Form der Registerkarte, die zum Zeichnen der Registerkarte verwendet wird; standardmäßig ist dies „ QTabBar::RoundedNorth “.
Siehe auch QTabBar::Shape.
int QStyleOptionTab::tabIndex
Diese Variable enthält den Index der aktuell angezeigten Registerkarte.
Der Standardwert ist -1, d. h. eine Registerkarte, die sich nicht auf einer Registerkartenleiste befindet;
QString QStyleOptionTab::text
Diese Variable enthält den Text der Registerkarte
Der Standardwert ist eine leere Zeichenfolge.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
