QStyleOptionTab Class

Die Klasse QStyleOptionTab wird verwendet, um die Parameter für das Zeichnen einer Registerkartenleiste zu beschreiben. Mehr...

Kopfzeile: #include <QStyleOptionTab>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Vererbt: 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 }
flags TabFeatures
enum TabPosition { Beginning, Middle, End, OnlyOneTab, Moving }

Öffentliche Funktionen

QStyleOptionTab()
QStyleOptionTab(const QStyleOptionTab &other)

Ö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

Detaillierte Beschreibung

Die Klasse QStyleOptionTab wird zum Zeichnen mehrerer eingebauter Qt-Widgets verwendet, darunter QTabBar und das Panel für QTabWidget.

Eine Instanz der Klasse QStyleOptionTab hat type SO_Tab und version 3. 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 Ihre eigene QStyleOption Unterklasse und Ihre eigenen Stile erstellen. Die Version wird von QStyleOption Unterklassen verwendet, um Erweiterungen zu implementieren, ohne die Kompatibilität zu beeinträchtigen. Wenn Sie qstyleoption_cast() verwenden, brauchen Sie dies normalerweise nicht zu überprüfen.

Aus Leistungsgründen gibt es nur wenige Mitgliedsfunktionen, und der Zugriff auf die Mitgliedsvariablen erfolgt direkt (d. h. mit dem Operator . oder -> ). Dies macht die Verwendung der Strukturen einfach und unterstreicht, dass es sich lediglich um Parameter handelt, die von den Stilfunktionen verwendet werden.

Siehe auch QStyleOption.

Dokumentation der Mitgliedstypen

enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets

Diese Flags zeigen die Eck-Widgets in einem Tab an.

KonstanteWertBeschreibung
QStyleOptionTab::NoCornerWidgets0x00Es gibt keine Eckwidgets
QStyleOptionTab::LeftCornerWidget0x01Linkes Eck-Widget
QStyleOptionTab::RightCornerWidget0x02Rechtes Eck-Widget

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 Aufzählung beschreibt die Position der ausgewählten Registerkarte. Einige Stile müssen eine Registerkarte anders zeichnen, je nachdem, ob sie an die ausgewählte Registerkarte angrenzt oder nicht.

KonstanteWertBeschreibung
QStyleOptionTab::NotAdjacent0Die Registerkarte grenzt nicht an eine ausgewählte Registerkarte an (oder ist die ausgewählte Registerkarte).
QStyleOptionTab::NextIsSelected1Der nächste Tabulator (normalerweise der Tabulator auf der rechten Seite) ist ausgewählt.
QStyleOptionTab::PreviousIsSelected2Die vorherige Registerkarte (normalerweise die Registerkarte auf der linken Seite) ist ausgewählt.

Siehe auch selectedPosition.

enum QStyleOptionTab::StyleOptionType

Diese Aufzählung wird verwendet, um Informationen über den Typ der Stiloption zu speichern, und ist für jede Unterklasse von QStyleOption definiert.

KonstanteWertBeschreibung
QStyleOptionTab::TypeSO_TabDer Typ der angebotenen 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 wollen Ihre eigene QStyleOption Unterklasse und Ihre eigenen Stile erstellen.

Siehe auch StyleOptionVersion.

enum QStyleOptionTab::StyleOptionVersion

Diese Aufzählung wird verwendet, um Informationen über die Version der Stiloption zu speichern, und ist für jede Unterklasse von QStyleOption definiert.

KonstanteWertBeschreibung
QStyleOptionTab::Version13

Die Version wird von QStyleOption Unterklassen verwendet, um Erweiterungen zu implementieren, ohne die Kompatibilität zu verletzen. Wenn Sie qstyleoption_cast() verwenden, brauchen Sie sie normalerweise nicht zu überprüfen.

Siehe auch StyleOptionType.

enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures

Beschreibt die verschiedenen Eigenschaften, die ein Tab-Button haben kann.

KonstanteWertBeschreibung
QStyleOptionTab::None0x00Ein normaler Tabulator-Button.
QStyleOptionTab::HasFrame0x01Der Tab-Button ist auf einem Tab-Rahmen positioniert

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 Aufzählung beschreibt die Position der Registerkarte.

KonstanteWertBeschreibung
QStyleOptionTab::Beginning0Die Registerkarte ist die erste Registerkarte in der Registerkartenleiste.
QStyleOptionTab::Middle1Die Registerkarte ist weder die erste noch die letzte Registerkarte in der Registerkartenleiste.
QStyleOptionTab::End2Die Registerkarte ist die letzte Registerkarte in der Registerkartenleiste.
QStyleOptionTab::OnlyOneTab3Die Registerkarte ist sowohl die erste als auch die letzte Registerkarte in der Registerkartenleiste.
QStyleOptionTab::Moving (since Qt 6.6)4Die Registerkarte wird durch Ziehen mit der Maus oder durch Animation bewegt.

Siehe auch position.

Dokumentation der Mitgliedsfunktionen

QStyleOptionTab::QStyleOptionTab()

Konstruiert ein QStyleOptionTab-Objekt, wobei die Variablen der Mitglieder auf ihre Standardwerte initialisiert werden.

QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)

Konstruiert eine Kopie der Stiloption other.

Dokumentation der Mitgliedsvariablen

QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets

Diese Variable enthält eine ODER-Kombination von CornerWidget Werten, die die Eckwidgets der Registerkartenleiste angeben

Der Standardwert ist NoCornerWidgets.

Siehe auch CornerWidget.

bool QStyleOptionTab::documentMode

Diese Variable gibt an, ob sich die Registerkartenleiste 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 eine Pixmap noch einen Dateinamen enthält.

QSize QStyleOptionTab::iconSize

Diese Variable enthält die Größe für die Symbole

Der Standardwert ist QSize(-1, -1), d.h. eine ungültige Größe; verwenden Sie QStyle::pixelMetric(), um die Standardgröße der Icons für Registerkartenleisten zu ermitteln.

Siehe auch QTabBar::iconSize().

QSize QStyleOptionTab::leftButtonSize

Diese Variable enthält die Größe für das linke Widget 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 gerade befindet

Der Standardwert ist 0, was die vorderste Zeile angibt. Derzeit kann diese Eigenschaft nur 0 sein.

QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition

Diese Variable enthält die Position der ausgewählten Registerkarte im Verhältnis zu dieser Registerkarte

Der Standardwert ist NotAdjacent, d.h. die Registerkarte grenzt weder an eine ausgewählte Registerkarte noch ist sie die ausgewählte Registerkarte.

QTabBar::Shape QStyleOptionTab::shape

Diese Variable enthält die Tabulatorform, die zum Zeichnen des Tabulators verwendet wird; standardmäßig QTabBar::RoundedNorth.

Siehe auch QTabBar::Shape.

int QStyleOptionTab::tabIndex

Diese Variable enthält den Index für die dargestellte Registerkarte.

Der Standardwert ist -1, d. h. eine Registerkarte, die sich nicht in einer Registerkartenleiste befindet;

QString QStyleOptionTab::text

Diese Variable enthält den Text der Registerkarte

Der Standardwert ist eine leere Zeichenkette.

© 2025 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.