QStyleOptionViewItem Class
La classe `QStyleOptionViewItem` sert à définir les paramètres utilisés pour dessiner un élément dans un widget de vue. En savoir plus...
| En-tête : | #include <QStyleOptionViewItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QStyleOption |
Types publics
| 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 } |
Fonctions publiques
| QStyleOptionViewItem() | |
| QStyleOptionViewItem(const QStyleOptionViewItem &other) | |
| QStyleOptionViewItem & | operator=(const QStyleOptionViewItem &) |
Variables publiques
| 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 |
Description détaillée
QStyleOptionViewItem contient toutes les informations dont les fonctions QStyle ont besoin pour dessiner les éléments destinés aux classes modèle/vue de Qt.
Pour des raisons de performances, il y a peu de fonctions membres et l'accès aux variables membres est direct (c'est-à-dire à l'aide des opérateurs ` . ` ou ` -> `). Cela rend ces structures simples à utiliser et souligne le fait qu'il s'agit simplement de paramètres utilisés par les fonctions de style.
Voir également « QStyleOption » et « Programmation modèle/vue ».
Documentation sur les types de membres
enum QStyleOptionViewItem::Position
Cette énumération décrit la position de la décoration de l'élément.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionViewItem::Left | 0 | À gauche du texte. |
QStyleOptionViewItem::Right | 1 | À droite du texte. |
QStyleOptionViewItem::Top | 2 | Au-dessus du texte. |
QStyleOptionViewItem::Bottom | 3 | En dessous du texte. |
Voir aussi decorationPosition.
enum QStyleOptionViewItem::StyleOptionType
Cette énumération sert à stocker des informations sur le type de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionViewItem::Type | SO_ViewItem | Le type de l’option de style fournie (SO_ViewItem pour cette classe). |
Ce type est utilisé en interne par ` QStyleOption`, ses sous-classes et la méthode ` qstyleoption_cast()` pour déterminer le type de l'option de style. En général, vous n'avez pas à vous en soucier, sauf si vous souhaitez créer votre propre sous-classe de ` QStyleOption ` et vos propres styles.
Voir également StyleOptionVersion.
enum QStyleOptionViewItem::StyleOptionVersion
Cette énumération sert à contenir des informations sur la version de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionViewItem::Version | 1 | 4 |
La version est utilisée par les sous-classes de ` QStyleOption ` pour implémenter des extensions sans rompre la compatibilité. Si vous utilisez ` qstyleoption_cast()`, vous n'avez normalement pas besoin de la vérifier.
Voir aussi StyleOptionType.
enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures
Cette énumération décrit les différents types de caractéristiques qu'un élément peut présenter.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | Indique un élément normal. |
QStyleOptionViewItem::WrapText | 0x01 | Indique un élément avec du texte justifié. |
QStyleOptionViewItem::Alternate | 0x02 | Indique que l'arrière-plan de l'élément est rendu à l'aide de alternateBase. |
QStyleOptionViewItem::HasCheckIndicator | 0x04 | Indique que l'élément dispose d'un indicateur d'état coché. |
QStyleOptionViewItem::HasDisplay | 0x08 | Indique que l'élément a un rôle d'affichage. |
QStyleOptionViewItem::HasDecoration | 0x10 | Indique que l'élément a un rôle de décoration. |
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9) | 0x20 | Indique que l'élément comporte une partie de branche d'arborescence à dessiner. |
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9) | 0x40 | Indique que l'élément contient les informations nécessaires au dessin de la partie de branche de l'arborescence. |
Le type `ViewItemFeatures` est un `typedef` pour ` QFlags<ViewItemFeature>`. Il stocke une combinaison OU de valeurs `ViewItemFeature`.
enum QStyleOptionViewItem::ViewItemPosition
Cette énumération sert à représenter l'emplacement de l'élément sur une ligne. Elle permet de dessiner les éléments différemment en fonction de leur emplacement, par exemple en leur attribuant des bords arrondis au début et à la fin, et des bords droits entre les deux.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionViewItem::Invalid | 0 | La valeur ViewItemPosition est inconnue et doit être ignorée. |
QStyleOptionViewItem::Beginning | 1 | L'élément apparaît au début de la ligne. |
QStyleOptionViewItem::Middle | 2 | L'élément apparaît au milieu de la ligne. |
QStyleOptionViewItem::End | 3 | L'élément apparaît à la fin de la ligne. |
QStyleOptionViewItem::OnlyOne | 4 | L'élément est le seul de la ligne ; il se trouve donc à la fois au début et à la fin. |
Documentation des fonctions membres
QStyleOptionViewItem::QStyleOptionViewItem()
Crée un objet `QStyleOptionViewItem` en initialisant les variables membres à leurs valeurs par défaut.
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
Crée une copie de l'option de style « other ».
[noexcept default] QStyleOptionViewItem &QStyleOptionViewItem::operator=(const QStyleOptionViewItem &)
Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionViewItem `.
Documentation sur les variables membres
QBrush QStyleOptionViewItem::backgroundBrush
L'QBrush e à utiliser pour peindre l'arrière-plan des éléments de la vue.
Qt::CheckState QStyleOptionViewItem::checkState
Si cet élément de la vue est cochable, c'est-à-dire si la propriété « ViewItemFeature::HasCheckIndicator » est définie sur « true », la propriété « checkState » est définie sur « true » si l'élément est coché ; dans le cas contraire, elle est définie sur « false ».
Qt::Alignment QStyleOptionViewItem::decorationAlignment
Cette variable détermine l'alignement de la décoration de l'élément
La valeur par défaut est « Qt::AlignLeft ».
QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition
Cette variable contient la position de la décoration de l'élément
La valeur par défaut est Left.
Voir aussi Position.
QSize QStyleOptionViewItem::decorationSize
Cette variable contient la taille de la décoration de l'élément
La valeur par défaut est QSize(-1, -1), c'est-à-dire une taille non valide.
Voir également decorationAlignment et decorationPosition.
Qt::Alignment QStyleOptionViewItem::displayAlignment
Cette variable détermine l'alignement de la valeur affichée pour l'élément
La valeur par défaut est « Qt::AlignLeft ».
QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features
Cette variable contient le résultat d'une opération OR binaire entre les caractéristiques qui décrivent cet élément de vue
Voir également ViewItemFeature.
QFont QStyleOptionViewItem::font
Cette variable contient la police utilisée pour l'élément
Par défaut, c'est la police par défaut de l'application qui est utilisée.
Voir également QFont.
QIcon QStyleOptionViewItem::icon
L'icône (le cas échéant) à afficher dans l'élément de la vue.
QModelIndex QStyleOptionViewItem::index
L'index du modèle à tracer.
QLocale QStyleOptionViewItem::locale
Cette variable contient les paramètres régionaux à utiliser pour l'affichage du texte, des nombres et des dates.
Cela permet au thème d'afficher, par exemple, les dates dans une locale différente de la locale par défaut de l'application.
bool QStyleOptionViewItem::showDecorationSelected
Cette variable indique si la décoration doit être mise en évidence sur les éléments sélectionnés
Si cette option est définie sur « true », la branche et toutes les décorations des éléments sélectionnés doivent être mises en surbrillance, indiquant ainsi que l'élément est sélectionné ; dans le cas contraire, aucune mise en surbrillance n'est nécessaire. La valeur par défaut est « false ».
Voir également QStyle::SH_ItemView_ShowDecorationSelected et QAbstractItemView.
QString QStyleOptionViewItem::text
Le texte (le cas échéant) à afficher dans l'élément de vue.
Qt::TextElideMode QStyleOptionViewItem::textElideMode
là où il convient d'ajouter des points de suspension lorsque le texte est trop long pour tenir dans un élément
La valeur par défaut est Qt::ElideMiddle, c'est-à-dire que les points de suspension apparaissent au milieu du texte.
Voir également Qt::TextElideMode et QStyle::SH_ItemView_EllipsisLocation.
QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition
Indique la position de cet élément d'affichage par rapport aux autres éléments. Pour plus de détails, consultez l'énumération ViewItemPosition.
const QWidget *QStyleOptionViewItem::widget
Cette variable contient le widget parent de l'élément
Ce membre contient le widget parent (itemview) de l'élément afin de pouvoir, par exemple, accéder à certaines propriétés au sein des méthodes QStyledItemDelegate.
© 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.
