QStyleOptionTab Class
La classe QStyleOptionTab sert à définir les paramètres de dessin d'une barre d'onglets. En savoir plus...
| En-tête : | #include <QStyleOptionTab> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QStyleOption |
Types publics
| enum | CornerWidget { NoCornerWidgets, LeftCornerWidget, RightCornerWidget } |
| flags | CornerWidgets |
| enum | SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | TabFeature { None, HasFrame, MinimumSizeHint } |
| flags | TabFeatures |
| enum | TabPosition { Beginning, Middle, End, OnlyOneTab, Moving } |
Fonctions publiques
| QStyleOptionTab() | |
| QStyleOptionTab(const QStyleOptionTab &other) | |
| QStyleOptionTab & | operator=(const QStyleOptionTab &) |
Variables publiques
| QStyleOptionTab::CornerWidgets | cornerWidgets |
| bool | documentMode |
| QIcon | icon |
| QSize | iconSize |
| QSize | leftButtonSize |
| QStyleOptionTab::TabPosition | position |
| QSize | rightButtonSize |
| int | row |
| QStyleOptionTab::SelectedPosition | selectedPosition |
| QTabBar::Shape | shape |
| int | tabIndex |
| QString | text |
Description détaillée
La classe QStyleOptionTab est utilisée pour dessiner plusieurs widgets Qt intégrés, notamment QTabBar et le panneau de QTabWidget.
Une instance de la classe QStyleOptionTab possède les propriétés type, SO_Tab et version 3. Ce type est utilisé en interne par QStyleOption, ses sous-classes et qstyleoption_cast() pour déterminer le type d’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. 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.
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 de 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 membres
enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets
Ces indicateurs signalent les widgets situés dans les coins d'un onglet.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionTab::NoCornerWidgets | 0x00 | Il n'y a pas de widgets d'angle |
QStyleOptionTab::LeftCornerWidget | 0x01 | Widget d'angle gauche |
QStyleOptionTab::RightCornerWidget | 0x02 | Widget de coin droit |
Le type CornerWidgets est une définition de type (typedef) pour QFlags<CornerWidget>. Il stocke une combinaison OR de valeurs CornerWidget.
Voir aussi cornerWidgets.
enum QStyleOptionTab::SelectedPosition
Cette énumération décrit la position de l'onglet sélectionné. Certains styles doivent afficher un onglet différemment selon qu'il est adjacent ou non à l'onglet sélectionné.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionTab::NotAdjacent | 0 | L'onglet n'est pas adjacent à un onglet sélectionné (ou est lui-même l'onglet sélectionné). |
QStyleOptionTab::NextIsSelected | 1 | L'onglet suivant (généralement celui de droite) est sélectionné. |
QStyleOptionTab::PreviousIsSelected | 2 | L'onglet précédent (généralement celui de gauche) est sélectionné. |
Voir aussi selectedPosition.
enum QStyleOptionTab::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 |
|---|---|---|
QStyleOptionTab::Type | SO_Tab | Le type de l'option de style fournie (SO_Tab 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 QStyleOptionTab::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 |
|---|---|---|
QStyleOptionTab::Version | 1 | 3 |
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.
enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures
Décrit les différentes fonctionnalités qu'un bouton d'onglet peut offrir.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionTab::None | 0x00 | Un bouton d’onglet standard. |
QStyleOptionTab::HasFrame | 0x01 | Le bouton d'onglet est positionné sur un cadre d'onglet |
QStyleOptionTab::MinimumSizeHint (since Qt 6.9) | 0x02 | La taille minimale du bouton d’onglet est en cours de calcul, contrairement à sa taille normale. |
Le type TabFeatures est un typedef pour QFlags<TabFeature>. Il stocke une combinaison OR de valeurs TabFeature.
Voir aussi QStyleOptionToolBar::features.
enum QStyleOptionTab::TabPosition
Cette énumération décrit la position de l'onglet.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionTab::Beginning | 0 | L'onglet est le premier de la barre d'onglets. |
QStyleOptionTab::Middle | 1 | L'onglet n'est ni le premier ni le dernier de la barre d'onglets. |
QStyleOptionTab::End | 2 | Cet onglet est le dernier de la barre d'onglets. |
QStyleOptionTab::OnlyOneTab | 3 | L'onglet est à la fois le premier et le dernier de la barre d'onglets. |
QStyleOptionTab::Moving (since Qt 6.6) | 4 | L'onglet se déplace par glissement de la souris ou par animation. |
Voir aussi position.
Documentation sur les fonctions membres
QStyleOptionTab::QStyleOptionTab()
Crée un objet QStyleOptionTab en initialisant les variables membres à leurs valeurs par défaut.
QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)
Crée une copie de l'option de style « other ».
[noexcept default] QStyleOptionTab &QStyleOptionTab::operator=(const QStyleOptionTab &)
Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionTab `.
Documentation sur les variables membres
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
Cette variable contient une combinaison « OU » de valeurs de type ` CornerWidget ` indiquant les widgets d'angle de la barre d'onglets
La valeur par défaut est « NoCornerWidgets ».
Voir également CornerWidget.
bool QStyleOptionTab::documentMode
Cette variable indique si la barre d'onglets est en mode document.
La valeur par défaut est « false » ;
QIcon QStyleOptionTab::icon
Cette variable contient l'icône de l'onglet
La valeur par défaut est une icône vide, c'est-à-dire une icône ne comportant ni image bitmap ni nom de fichier.
QSize QStyleOptionTab::iconSize
Cette variable contient la taille des icônes
La valeur par défaut est QSize(-1, -1), c'est-à-dire une taille non valide ; utilisez QStyle::pixelMetric() pour connaître la taille par défaut des icônes dans les barres d'onglets.
Voir également QTabBar::iconSize().
QSize QStyleOptionTab::leftButtonSize
Cette variable contient la taille du widget de gauche sur l'onglet.
La valeur par défaut est QSize(-1, -1), c'est-à-dire une taille non valide ;
QStyleOptionTab::TabPosition QStyleOptionTab::position
Cette variable contient la position de l'onglet dans la barre d'onglets
La valeur par défaut est « Beginning », ce qui signifie que l'onglet est le premier de la barre d'onglets.
QSize QStyleOptionTab::rightButtonSize
Cette variable contient la taille du widget de droite sur l'onglet.
La valeur par défaut est QSize(-1, -1), c'est-à-dire une taille non valide ;
int QStyleOptionTab::row
Cette variable indique la ligne dans laquelle se trouve actuellement l'onglet
La valeur par défaut est 0, ce qui correspond à la ligne de devant. Actuellement, cette propriété ne peut prendre que la valeur 0.
QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition
Cette variable indique la position de l'onglet sélectionné par rapport à cet onglet
La valeur par défaut est NotAdjacent, ce qui signifie que l'onglet n'est ni adjacent à un onglet sélectionné, ni lui-même l'onglet sélectionné.
QTabBar::Shape QStyleOptionTab::shape
Cette variable contient la forme de l'onglet utilisée pour le dessiner ; par défaut, QTabBar::RoundedNorth.
Voir également QTabBar::Shape.
int QStyleOptionTab::tabIndex
Cette variable contient l'index de l'onglet affiché.
La valeur par défaut est -1, c'est-à-dire un onglet qui ne figure pas dans une barre d'onglets ;
QString QStyleOptionTab::text
Cette variable contient le texte de l'onglet
La valeur par défaut est une chaîne vide.
© 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.
