QStyleOptionViewItem Class
La classe QStyleOptionViewItem permet de décrire les paramètres utilisés pour dessiner un élément dans un widget de vue. Plus d'informations...
| En-tête : | #include <QStyleOptionViewItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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) |
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 de QStyle ont besoin pour dessiner les éléments des classes de modèle/vue de Qt.
Pour des raisons de performance, il y a peu de fonctions membres et l'accès aux variables membres est direct (c'est-à-dire en utilisant l'opérateur . ou -> ). Cela rend les 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 Model/View Programming.
Documentation des 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 est utilisée pour contenir 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 | Type d'option de style fournie (SO_ViewItem pour cette classe). |
Le type est utilisé en interne par QStyleOption, ses sous-classes et qstyleoption_cast() pour déterminer le type de l'option de style. En général, vous n'avez pas besoin de vous en préoccuper, sauf si vous souhaitez créer votre propre sous-classe QStyleOption et vos propres styles.
Voir aussi StyleOptionVersion.
enum QStyleOptionViewItem::StyleOptionVersion
Cette énumération est utilisée pour contenir des informations sur la version de l'option de style et est définie pour chaque sous-classe de QStyleOption.
| Constante | Valeur | Description de l'option |
|---|---|---|
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 également StyleOptionType.
enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures
Cette énumération décrit les différents types de caractéristiques qu'un élément peut avoir.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | Indique un élément normal. |
QStyleOptionViewItem::WrapText | 0x01 | Indique un élément avec du texte enveloppé. |
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 possède un indicateur d'état de vérification. |
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 a une partie de branche arborescente à peindre. |
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9) | 0x40 | Indique que l'élément contient les informations nécessaires pour dessiner la partie de la 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 est utilisée pour représenter l'emplacement de l'élément sur une ligne. Elle peut être utilisée pour dessiner les éléments différemment en fonction de leur emplacement, par exemple en plaçant des bords arrondis au début et à la fin, et des bords droits entre les deux.
| Constante | Valeur | Description de la constante |
|---|---|---|
QStyleOptionViewItem::Invalid | 0 | ViewItemPosition est inconnue et ne doit pas être prise en compte. |
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 et se trouve donc à la fois au début et à la fin. |
Documentation sur les fonctions membres
QStyleOptionViewItem::QStyleOptionViewItem()
Construit un QStyleOptionViewItem, en initialisant les variables membres à leurs valeurs par défaut.
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
Construit une copie de l'option de style other.
Documentation des variables membres
QBrush QStyleOptionViewItem::backgroundBrush
QBrush qui doit être utilisé pour peindre l'arrière-plan des éléments de la vue.
Qt::CheckState QStyleOptionViewItem::checkState
Si cet élément de la vue est vérifiable, c'est-à-dire si ViewItemFeature::HasCheckIndicator est vrai, checkState est vrai si l'élément est vérifié ; sinon, il est faux.
Qt::Alignment QStyleOptionViewItem::decorationAlignment
Cette variable contient l'alignement de la décoration de l'article
La valeur par défaut est Qt::AlignLeft.
QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition
Cette variable contient la position de la décoration de l'article
La valeur par défaut est Left.
Voir aussi Position.
QSize QStyleOptionViewItem::decorationSize
Cette variable contient la taille de la décoration de l'article
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 contient l'alignement de la valeur d'affichage de l'élément
La valeur par défaut est Qt::AlignLeft.
QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features
Cette variable contient un OU binaire des caractéristiques qui décrivent cet élément de vue
Voir aussi ViewItemFeature.
QFont QStyleOptionViewItem::font
Cette variable contient la police utilisée pour l'élément
Par défaut, la police par défaut de l'application est utilisée.
Voir aussi QFont.
QIcon QStyleOptionViewItem::icon
L'icône (s'il y en a une) à dessiner dans l'élément de la vue.
QModelIndex QStyleOptionViewItem::index
L'index du modèle à dessiner.
QLocale QStyleOptionViewItem::locale
Cette variable contient la locale à utiliser pour l'affichage du texte, des nombres et des dates.
Cela permet au style 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 vraie, la branche et les décorations éventuelles des éléments sélectionnés doivent être mises en évidence, ce qui indique que l'élément est sélectionné ; dans le cas contraire, aucune mise en évidence n'est nécessaire. La valeur par défaut est false.
Voir également QStyle::SH_ItemView_ShowDecorationSelected et QAbstractItemView.
QString QStyleOptionViewItem::text
Le texte (s'il y en a un) à dessiner dans l'élément de la vue.
Qt::TextElideMode QStyleOptionViewItem::textElideMode
l'endroit où les points de suspension doivent être ajoutés pour les textes trop longs pour être insérés dans un article.
La valeur par défaut est Qt::ElideMiddle, c'est-à-dire que l'ellipse apparaît au milieu du texte.
Voir également Qt::TextElideMode et QStyle::SH_ItemView_EllipsisLocation.
QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition
Indique la position de cet élément de la vue par rapport aux autres éléments. Voir l'énumération ViewItemPosition pour plus de détails.
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 dans les 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.