Sur cette page

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.

ConstanteValeurDescription
QStyleOptionViewItem::Left0À gauche du texte.
QStyleOptionViewItem::Right1À droite du texte.
QStyleOptionViewItem::Top2Au-dessus du texte.
QStyleOptionViewItem::Bottom3En 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.

ConstanteValeurDescription
QStyleOptionViewItem::TypeSO_ViewItemType 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.

ConstanteValeurDescription de l'option
QStyleOptionViewItem::Version14

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.

ConstanteValeurDescription
QStyleOptionViewItem::None0x00Indique un élément normal.
QStyleOptionViewItem::WrapText0x01Indique un élément avec du texte enveloppé.
QStyleOptionViewItem::Alternate0x02Indique que l'arrière-plan de l'élément est rendu à l'aide de alternateBase.
QStyleOptionViewItem::HasCheckIndicator0x04Indique que l'élément possède un indicateur d'état de vérification.
QStyleOptionViewItem::HasDisplay0x08Indique que l'élément a un rôle d'affichage.
QStyleOptionViewItem::HasDecoration0x10Indique que l'élément a un rôle de décoration.
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9)0x20Indique que l'élément a une partie de branche arborescente à peindre.
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9)0x40Indique 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.

ConstanteValeurDescription de la constante
QStyleOptionViewItem::Invalid0ViewItemPosition est inconnue et ne doit pas être prise en compte.
QStyleOptionViewItem::Beginning1L'élément apparaît au début de la ligne.
QStyleOptionViewItem::Middle2L'élément apparaît au milieu de la ligne.
QStyleOptionViewItem::End3L'élément apparaît à la fin de la ligne.
QStyleOptionViewItem::OnlyOne4L'é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.