QStyleOptionViewItem Class
Die Klasse „QStyleOptionViewItem“ dient dazu, die Parameter zu beschreiben, die zum Zeichnen eines Elements in einem View-Widget verwendet werden. Mehr...
| Header: | #include <QStyleOptionViewItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QStyleOption |
Öffentliche Typen
| enum | Position { Left, Right, Top, Bottom } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ViewItemFeature { None, WrapText, Alternate, HasCheckIndicator, HasDisplay, …, IsDecorationForRootColumn } |
| flags | ViewItemFeatures |
| enum | ViewItemPosition { Invalid, Beginning, Middle, End, OnlyOne } |
Öffentliche Funktionen
| QStyleOptionViewItem() | |
| QStyleOptionViewItem(const QStyleOptionViewItem &other) | |
| QStyleOptionViewItem & | operator=(const QStyleOptionViewItem &) |
Öffentliche Variablen
| QBrush | backgroundBrush |
| Qt::CheckState | checkState |
| Qt::Alignment | decorationAlignment |
| QStyleOptionViewItem::Position | decorationPosition |
| QSize | decorationSize |
| Qt::Alignment | displayAlignment |
| QStyleOptionViewItem::ViewItemFeatures | features |
| QFont | font |
| QIcon | icon |
| QModelIndex | index |
| QLocale | locale |
| bool | showDecorationSelected |
| QString | text |
| Qt::TextElideMode | textElideMode |
| QStyleOptionViewItem::ViewItemPosition | viewItemPosition |
| const QWidget * | widget |
Ausführliche Beschreibung
QStyleOptionViewItem enthält alle Informationen, die die Funktionen von „ QStyle “ benötigen, um die Elemente für die Modell-/Ansichtsklassen von Qt zu zeichnen.
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 “ und „Model/View-Programmierung“.
Dokumentation zu Mitgliedstypen
enum QStyleOptionViewItem::Position
Diese Enumeration beschreibt die Position der Verzierung des Elements.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionViewItem::Left | 0 | Links vom Text. |
QStyleOptionViewItem::Right | 1 | Rechts vom Text. |
QStyleOptionViewItem::Top | 2 | Über dem Text. |
QStyleOptionViewItem::Bottom | 3 | Unterhalb des Textes. |
Siehe auch decorationPosition.
enum QStyleOptionViewItem::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 |
|---|---|---|
QStyleOptionViewItem::Type | SO_ViewItem | Der Typ der bereitgestellten Stiloption (SO_ViewItem 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 QStyleOptionViewItem::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 |
|---|---|---|
QStyleOptionViewItem::Version | 1 | 4 |
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 diese normalerweise nicht überprüfen.
Siehe auch ` StyleOptionType`.
enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures
Diese Aufzählung beschreibt die verschiedenen Arten von Merkmalen, die ein Element aufweisen kann.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | Bezeichnet ein normales Element. |
QStyleOptionViewItem::WrapText | 0x01 | Bezeichnet ein Element mit umgebrochenem Text. |
QStyleOptionViewItem::Alternate | 0x02 | Gibt an, dass der Hintergrund des Elements mithilfe von „alternateBase“ gerendert wird. |
QStyleOptionViewItem::HasCheckIndicator | 0x04 | Gibt an, dass das Element über eine Markierungsanzeige verfügt. |
QStyleOptionViewItem::HasDisplay | 0x08 | Gibt an, dass das Element eine Anzeigerolle hat. |
QStyleOptionViewItem::HasDecoration | 0x10 | Zeigt an, dass das Element eine Dekorationsrolle hat. |
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9) | 0x20 | Zeigt an, dass das Element einen Zweigteil der Baumansicht zum Zeichnen enthält. |
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9) | 0x40 | Gibt an, dass das Element die Informationen zum Zeichnen des Zweigteils der Baumansicht enthält. |
Der Typ „ViewItemFeatures“ ist ein Typedef für „QFlags<ViewItemFeature>“. Er speichert eine ODER-Kombination von „ViewItemFeature“-Werten.
enum QStyleOptionViewItem::ViewItemPosition
Diese Enumeration dient dazu, die Position des Elements in einer Zeile darzustellen. Damit lassen sich Elemente je nach ihrer Position unterschiedlich darstellen, beispielsweise indem am Anfang und am Ende abgerundete Kanten und dazwischen gerade Kanten eingefügt werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionViewItem::Invalid | 0 | Die „ViewItemPosition“ ist unbekannt und sollte ignoriert werden. |
QStyleOptionViewItem::Beginning | 1 | Das Element erscheint am Anfang der Zeile. |
QStyleOptionViewItem::Middle | 2 | Das Element erscheint in der Mitte der Zeile. |
QStyleOptionViewItem::End | 3 | Das Element erscheint am Ende der Zeile. |
QStyleOptionViewItem::OnlyOne | 4 | Das Element ist das einzige in der Zeile und befindet sich daher sowohl am Anfang als auch am Ende. |
Dokumentation der Member-Funktionen
QStyleOptionViewItem::QStyleOptionViewItem()
Erstellt ein `QStyleOptionViewItem` und initialisiert die Membervariablen mit ihren Standardwerten.
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
Erstellt eine Kopie der Stiloption „ other “.
[noexcept default] QStyleOptionViewItem &QStyleOptionViewItem::operator=(const QStyleOptionViewItem &)
other Weist dieser Instanz von „ QStyleOptionViewItem “ durch Kopieren den Wert „ “ zu. “ zu dieser Instanz von „ “ zu.
Dokumentation zu Member-Variablen
QBrush QStyleOptionViewItem::backgroundBrush
Die ` QBrush `, die zum Ausmalen des Hintergrunds der View-Elemente verwendet werden soll.
Qt::CheckState QStyleOptionViewItem::checkState
Wenn dieses Ansichtselement markierbar ist, d. h. „ ViewItemFeature::HasCheckIndicator “ ist wahr, ist „ checkState “ wahr, wenn das Element markiert ist; andernfalls ist es falsch.
Qt::Alignment QStyleOptionViewItem::decorationAlignment
Diese Variable enthält die Ausrichtung der Verzierung für das Element
Der Standardwert lautet „ Qt::AlignLeft “.
QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition
Diese Variable enthält die Position der Verzierung für das Element
Der Standardwert lautet „ Left “.
Siehe auch Position.
QSize QStyleOptionViewItem::decorationSize
Diese Variable enthält die Größe der Verzierung für das Element
Der Standardwert ist „ QSize “ (-1, -1), d. h. eine ungültige Größe.
Siehe auch „ decorationAlignment “ und „ decorationPosition “.
Qt::Alignment QStyleOptionViewItem::displayAlignment
Diese Variable enthält die Ausrichtung des Anzeigewerts für das Element
Der Standardwert lautet „ Qt::AlignLeft “.
QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features
Diese Variable enthält ein bitweises ODER der Merkmale, die dieses Ansichtsobjekt beschreiben
Siehe auch ViewItemFeature.
QFont QStyleOptionViewItem::font
Diese Variable enthält die für das Element verwendete Schriftart
Standardmäßig wird die Standardschriftart der Anwendung verwendet.
Siehe auch QFont.
QIcon QStyleOptionViewItem::icon
Das Symbol (falls vorhanden), das im Ansichtselement gezeichnet werden soll.
QModelIndex QStyleOptionViewItem::index
Der Modellindex, der gezeichnet werden soll.
QLocale QStyleOptionViewItem::locale
Diese Variable enthält die zu verwendende Ländereinstellung für die Anzeige von Text, Zahlen und Datumsangaben.
Dadurch kann das Design beispielsweise Datumsangaben in einer anderen Ländereinstellung als der Standard-Ländereinstellung der Anwendung anzeigen.
bool QStyleOptionViewItem::showDecorationSelected
Diese Variable gibt an, ob die Dekoration bei ausgewählten Elementen hervorgehoben werden soll
Ist diese Option auf „true“ gesetzt, sollten der Zweig und alle Dekorationen auf ausgewählten Elementen hervorgehoben werden, um anzuzeigen, dass das Element ausgewählt ist; andernfalls ist keine Hervorhebung erforderlich. Der Standardwert ist „false“.
Siehe auch QStyle::SH_ItemView_ShowDecorationSelected und QAbstractItemView.
QString QStyleOptionViewItem::text
Der Text (falls vorhanden), der im Ansichtsobjekt eingezeichnet werden soll.
Qt::TextElideMode QStyleOptionViewItem::textElideMode
wo bei Text, der zu lang ist, um in ein Element zu passen, eine Ellipse eingefügt werden sollte
Der Standardwert ist „ Qt::ElideMiddle “, d. h., die Auslassungspunkte erscheinen in der Mitte des Textes.
Siehe auch Qt::TextElideMode und QStyle::SH_ItemView_EllipsisLocation.
QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition
Gibt die Position dieses Ansichtselements im Verhältnis zu anderen Elementen an. Einzelheiten finden Sie in der Aufzählung „ ViewItemPosition “.
const QWidget *QStyleOptionViewItem::widget
Diese Variable enthält das übergeordnete Widget des Elements
Dieses Element enthält das übergeordnete Widget (ItemView) des Elements, um beispielsweise innerhalb der Methoden „ QStyledItemDelegate “ auf bestimmte Eigenschaften zugreifen zu können.
© 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.
