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 : |
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.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionHeader::Beginning | 0 | Au début de l'en-tête |
QStyleOptionHeader::Middle | 1 | Au milieu de l'en-tête |
QStyleOptionHeader::End | 2 | À la fin de l'en-tête |
QStyleOptionHeader::OnlyOneSection | 3 | Une 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.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionHeader::NotAdjacent | 0 | Non adjacente à la section sélectionnée |
QStyleOptionHeader::NextIsSelected | 1 | La section suivante est sélectionnée |
QStyleOptionHeader::PreviousIsSelected | 2 | La section précédente est sélectionnée |
QStyleOptionHeader::NextAndPreviousAreSelected | 3 | Les 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é
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionHeader::None | 0 | Aucun indicateur de tri n'est nécessaire |
QStyleOptionHeader::SortUp | 1 | Dessiner un indicateur « haut » |
QStyleOptionHeader::SortDown | 2 | Tracer 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 `.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionHeader::Type | SO_Header | Le 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 `.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionHeader::Version | 1 | 1 |
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.