QStyleOptionViewItem Class
Die Klasse QStyleOptionViewItem wird verwendet, um die Parameter zu beschreiben, die zum Zeichnen eines Elements in einem View-Widget verwendet werden. Mehr...
| Kopfzeile: | #include <QStyleOptionViewItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbungen: | QStyleOption |
Öffentliche Typen
| enum | Position { Left, Right, Top, Bottom } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ViewItemFeature { None, WrapText, Alternate, HasCheckIndicator, HasDisplay, HasDecoration } |
| flags | ViewItemFeatures |
| enum | ViewItemPosition { Invalid, Beginning, Middle, End, OnlyOne } |
Öffentliche Funktionen
| QStyleOptionViewItem() | |
| QStyleOptionViewItem(const QStyleOptionViewItem &other) |
Ö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 |
Detaillierte Beschreibung
QStyleOptionViewItem enthält alle Informationen, die die QStyle Funktionen 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 . oder -> Operator). Dadurch sind die Strukturen einfach zu verwenden und es wird betont, dass es sich lediglich um Parameter handelt, die von den Style-Funktionen verwendet werden.
Siehe auch QStyleOption und Model/View Programming.
Dokumentation der Mitgliedstypen
enum QStyleOptionViewItem::Position
Diese Aufzählung beschreibt die Position der Dekoration des Artikels.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionViewItem::Left | 0 | Auf der linken Seite des Textes. |
QStyleOptionViewItem::Right | 1 | Auf der rechten Seite des Textes. |
QStyleOptionViewItem::Top | 2 | Oberhalb des Textes. |
QStyleOptionViewItem::Bottom | 3 | Unterhalb des Textes. |
Siehe auch decorationPosition.
enum QStyleOptionViewItem::StyleOptionType
Diese Aufzählung wird verwendet, um Informationen über den Typ der Stiloption zu speichern, und ist für jede Unterklasse von QStyleOption definiert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionViewItem::Type | SO_ViewItem | Der Typ der angebotenen 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 wollen Ihre eigene QStyleOption Unterklasse und Ihre eigenen Stile erstellen.
Siehe auch StyleOptionVersion.
enum QStyleOptionViewItem::StyleOptionVersion
Diese Aufzählung wird verwendet, um Informationen über die Version der Stiloption zu speichern, und ist für jede Unterklasse von QStyleOption definiert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionViewItem::Version | 1 | 4 |
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 QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures
Diese Aufzählung beschreibt die verschiedenen Arten von Eigenschaften, die ein Element haben kann.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | Zeigt ein normales Element an. |
QStyleOptionViewItem::WrapText | 0x01 | Zeigt ein Element mit umbrochenem Text an. |
QStyleOptionViewItem::Alternate | 0x02 | Zeigt an, dass der Hintergrund des Eintrags mit alternateBase gerendert wird. |
QStyleOptionViewItem::HasCheckIndicator | 0x04 | Zeigt an, dass das Element eine Prüfstatusanzeige hat. |
QStyleOptionViewItem::HasDisplay | 0x08 | Zeigt an, dass das Element eine Anzeigerolle hat. |
QStyleOptionViewItem::HasDecoration | 0x10 | Zeigt an, dass das Element eine Dekorationsrolle hat. |
Der Typ ViewItemFeatures ist ein Typedef für QFlags<ViewItemFeature>. Er speichert eine ODER-Kombination von ViewItemFeature-Werten.
enum QStyleOptionViewItem::ViewItemPosition
Diese Aufzählung wird verwendet, um die Platzierung des Elements in einer Reihe darzustellen. Dies kann verwendet werden, um Elemente je nach ihrer Platzierung unterschiedlich zu zeichnen, z. B. durch abgerundete Kanten am Anfang und Ende und gerade Kanten dazwischen.
| 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 | Der Eintrag steht 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 Mitgliedsfunktionen
QStyleOptionViewItem::QStyleOptionViewItem()
Konstruiert ein QStyleOptionViewItem und initialisiert die Variablen der Mitglieder auf ihre Standardwerte.
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
Konstruiert eine Kopie der Stiloption other.
Dokumentation der Mitgliedsvariablen
QBrush QStyleOptionViewItem::backgroundBrush
Die QBrush, die verwendet werden soll, um den Hintergrund der Ansichtselemente zu malen.
Qt::CheckState QStyleOptionViewItem::checkState
Wenn dieses Ansichtselement überprüfbar ist, d. h. ViewItemFeature::HasCheckIndicator wahr ist, ist checkState wahr, wenn das Element überprüft wird; andernfalls ist es falsch.
Qt::Alignment QStyleOptionViewItem::decorationAlignment
Diese Variable enthält die Ausrichtung der Dekoration für den Artikel
Der Standardwert ist Qt::AlignLeft.
QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition
Diese Variable enthält die Position der Dekoration für das Element
Der Standardwert ist Left.
Siehe auch Position.
QSize QStyleOptionViewItem::decorationSize
Diese Variable enthält die Größe der Dekoration 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 ist Qt::AlignLeft.
QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features
Diese Variable enthält ein bitweises ODER der Merkmale, die dieses Ansichtselement 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 das Gebietsschema, das für die Anzeige von Text, Zahlen und Daten verwendet werden soll.
Dadurch kann der Stil z. B. Datumsangaben in einem anderen Gebietsschema anzeigen als dem Standardgebietsschema der Anwendung.
bool QStyleOptionViewItem::showDecorationSelected
Diese Variable gibt an, ob die Dekoration auf ausgewählten Objekten hervorgehoben werden soll
Wenn diese Option true ist, 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 Ansichtselement gezeichnet werden soll.
Qt::TextElideMode QStyleOptionViewItem::textElideMode
wo die Ellipse für Text eingefügt werden soll, der zu lang ist, um in einen Artikel zu passen.
Der Standardwert ist Qt::ElideMiddle, d.h. die Ellipse erscheint in der Mitte des Textes.
Siehe auch Qt::TextElideMode und QStyle::SH_ItemView_EllipsisLocation.
QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition
Gibt die Position dieses Ansichtselements relativ zu anderen Elementen an. Siehe ViewItemPosition enum für die Details.
const QWidget *QStyleOptionViewItem::widget
Diese Variable enthält das übergeordnete Widget des Eintrags
Dieses Mitglied enthält das übergeordnete Widget (itemview) des Eintrags, um z.B. auf einige Eigenschaften innerhalb der QStyledItemDelegate Methoden zugreifen zu können.
© 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.
