Sur cette page

QStyleOptionHeader Class

La classe QStyleOptionHeader sert à définir les paramètres de dessin d'un en-tête. En savoir plus...

En-tête : #include <QStyleOptionHeader>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QStyleOption
Hérité par :

QStyleOptionHeaderV2

Types publics

enum SectionPosition { Beginning, Middle, End, OnlyOneSection }
enum SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected, NextAndPreviousAreSelected }
enum SortIndicator { None, SortUp, SortDown }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Fonctions publiques

QStyleOptionHeader()
QStyleOptionHeader(const QStyleOptionHeader &other)
QStyleOptionHeader &operator=(const QStyleOptionHeader &)

Variables publiques

QIcon icon
Qt::Alignment iconAlignment
Qt::Orientation orientation
QStyleOptionHeader::SectionPosition position
int section
QStyleOptionHeader::SelectedPosition selectedPosition
QStyleOptionHeader::SortIndicator sortIndicator
QString text
Qt::Alignment textAlignment

Description détaillée

QStyleOptionHeader contient toutes les informations dont les fonctions d'QStyle ont besoin pour dessiner le volet d'en-tête, la flèche de tri et l'étiquette d'en-tête des vues d'éléments.

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.

Documentation sur les types membres

enum QStyleOptionHeader::SectionPosition

Cette énumération vous permet de savoir où se situe la section par rapport aux autres sections.

ConstanteValeurDescription
QStyleOptionHeader::Beginning0Au début de l'en-tête
QStyleOptionHeader::Middle1Au milieu de l'en-tête
QStyleOptionHeader::End2À la fin de l'en-tête
QStyleOptionHeader::OnlyOneSection3Une seule section d'en-tête

Voir aussi position.

enum QStyleOptionHeader::SelectedPosition

Cette énumération vous permet de connaître la position de la section par rapport à la section sélectionnée.

ConstanteValeurDescription
QStyleOptionHeader::NotAdjacent0Non adjacente à la section sélectionnée
QStyleOptionHeader::NextIsSelected1La section suivante est sélectionnée
QStyleOptionHeader::PreviousIsSelected2La section précédente est sélectionnée
QStyleOptionHeader::NextAndPreviousAreSelected3Les sections suivante et précédente sont toutes deux sélectionnées

Voir aussi selectedPosition.

enum QStyleOptionHeader::SortIndicator

Indique dans quelle direction l'indicateur de tri doit être tracé

ConstanteValeurDescription
QStyleOptionHeader::None0Aucun indicateur de tri n'est nécessaire
QStyleOptionHeader::SortUp1Dessiner un indicateur « haut »
QStyleOptionHeader::SortDown2Tracer un indicateur de baisse

Voir aussi sortIndicator.

enum QStyleOptionHeader::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 `.

ConstanteValeurDescription
QStyleOptionHeader::TypeSO_HeaderLe type de l'option de style fournie (SO_Header 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 QStyleOptionHeader::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 `.

ConstanteValeurDescription
QStyleOptionHeader::Version11

Cette 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 généralement pas besoin de la vérifier.

Voir aussi StyleOptionType.

Documentation sur les fonctions membres

QStyleOptionHeader::QStyleOptionHeader()

Crée un objet `QStyleOptionHeader` en initialisant les variables membres à leurs valeurs par défaut.

QStyleOptionHeader::QStyleOptionHeader(const QStyleOptionHeader &other)

Crée une copie de l'option de style « other ».

[noexcept default] QStyleOptionHeader &QStyleOptionHeader::operator=(const QStyleOptionHeader &)

Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionHeader `.

Documentation sur les variables membres

QIcon QStyleOptionHeader::icon

Cette variable contient l'icône de l'en-tête

La valeur par défaut est une icône vide, c'est-à-dire une icône sans image ni nom de fichier.

Qt::Alignment QStyleOptionHeader::iconAlignment

Cette variable contient les indicateurs d'alignement de l'icône de l'en-tête

La valeur par défaut est « Qt::AlignLeft ».

Qt::Orientation QStyleOptionHeader::orientation

Cette variable contient l'orientation de l'en-tête (horizontale ou verticale)

L'orientation par défaut est Qt::Horizontal

QStyleOptionHeader::SectionPosition QStyleOptionHeader::position

Cette variable contient la position de la section par rapport aux autres sections

La valeur par défaut est « QStyleOptionHeader::Beginning ».

int QStyleOptionHeader::section

Cette variable indique quelle section de l'en-tête est en cours de dessin

La valeur par défaut est 0.

QStyleOptionHeader::SelectedPosition QStyleOptionHeader::selectedPosition

Cette variable contient la position de la section par rapport à la section sélectionnée

La valeur par défaut est QStyleOptionHeader::NotAdjacent

QStyleOptionHeader::SortIndicator QStyleOptionHeader::sortIndicator

Cette variable détermine la direction dans laquelle l'indicateur de tri doit être tracé

La valeur par défaut est QStyleOptionHeader::None.

QString QStyleOptionHeader::text

Cette variable contient le texte de l'en-tête

La valeur par défaut est une chaîne vide.

Qt::Alignment QStyleOptionHeader::textAlignment

Cette variable contient les indicateurs d'alignement du texte de l'en-tête

La valeur par défaut est « Qt::AlignLeft ».

© 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.