Sur cette page

QStyleOptionHeader Class

La classe QStyleOptionHeader est utilisée pour décrire les paramètres de dessin d'un en-tête. Plus d'informations...

En-tête : #include <QStyleOptionHeader>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite : 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)

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

Documentation sur les types de membres

enum QStyleOptionHeader::SectionPosition

Cette énumération permet de connaître la position de la section par rapport aux autres sections.

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

Voir aussi position.

enum QStyleOptionHeader::SelectedPosition

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

ConstanteValeurDescription de la section
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::NextAndPreviousAreSelected3La section suivante et la section précédente sont toutes deux sélectionnées

Voir également selectedPosition.

enum QStyleOptionHeader::SortIndicator

Indique la direction dans laquelle l'indicateur de tri doit être dessiné

ConstanteValeurDescription de l'indicateur de tri
QStyleOptionHeader::None0Aucun indicateur de tri n'est nécessaire
QStyleOptionHeader::SortUp1Dessine un indicateur vers le haut
QStyleOptionHeader::SortDown2Dessine un indicateur de baisse

Voir aussi sortIndicator.

enum QStyleOptionHeader::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
QStyleOptionHeader::TypeSO_HeaderType d'option de style fournie (SO_Header 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 QStyleOptionHeader::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
QStyleOptionHeader::Version11

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.

Documentation des fonctions membres

QStyleOptionHeader::QStyleOptionHeader()

Construit un QStyleOptionHeader, en initialisant les variables membres à leurs valeurs par défaut.

QStyleOptionHeader::QStyleOptionHeader(const QStyleOptionHeader &other)

Construit une copie de l'option de style other.

Documentation des 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 pixmap ni nom de fichier.

Qt::Alignment QStyleOptionHeader::iconAlignment

Cette variable contient les drapeaux d'alignement pour 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 indique la position de la section par rapport aux autres sections

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

int QStyleOptionHeader::section

Cette variable indique la section de l'en-tête qui est peinte

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 indique la direction dans laquelle l'indicateur de tri doit être dessiné

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 drapeaux d'alignement pour le 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.