QStyleOptionTab Class
La classe QStyleOptionTab est utilisée pour décrire les paramètres de dessin d'une barre d'onglets. Plus d'informations...
| En-tête : | #include <QStyleOptionTab> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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) |
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 Widgets intégrés, notamment QTabBar et le panneau de QTabWidget.
Une instance de la classe QStyleOptionTab possède type SO_Tab et version 3. Le 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 préoccuper, sauf si vous souhaitez créer votre propre sous-classe QStyleOption et vos propres styles. La version est utilisée par les sous-classes 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 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 des types de membres
enum QStyleOptionTab::CornerWidget
flags QStyleOptionTab::CornerWidgets
Ces drapeaux indiquent les widgets d'angle 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 d'angle droit |
Le type CornerWidgets est un typedef pour QFlags<CornerWidget>. Il stocke une combinaison OU de valeurs CornerWidget.
Voir également cornerWidgets.
enum QStyleOptionTab::SelectedPosition
Cette énumération décrit la position de l'onglet sélectionné. Certains styles doivent dessiner 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 l'onglet sélectionné). |
QStyleOptionTab::NextIsSelected | 1 | L'onglet suivant (typiquement l'onglet de droite) est sélectionné. |
QStyleOptionTab::PreviousIsSelected | 2 | L'onglet précédent (généralement l'onglet de gauche) est sélectionné. |
Voir également selectedPosition.
enum QStyleOptionTab::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.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionTab::Type | SO_Tab | Type d'option de style fournie (SO_Tab 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 QStyleOptionTab::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.
| Constante | Valeur | Description de l'option |
|---|---|---|
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 également StyleOptionType.
enum QStyleOptionTab::TabFeature
flags QStyleOptionTab::TabFeatures
Décrit les différentes caractéristiques que peut avoir un bouton d'onglet.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionTab::None | 0x00 | Bouton de tabulation normal. |
QStyleOptionTab::HasFrame | 0x01 | Le bouton de tabulation est positionné sur un cadre de tabulation |
QStyleOptionTab::MinimumSizeHint (since Qt 6.9) | 0x02 | L'indice de taille minimale du bouton de tabulation est mesuré, contrairement à son indice de taille normale. |
Le type TabFeatures est un typedef pour QFlags<TabFeature>. Il stocke une combinaison OR de valeurs TabFeatures.
Voir également QStyleOptionToolBar::features.
enum QStyleOptionTab::TabPosition
Cette énumération décrit la position de l'onglet.
| Constante | Valeur | Description de l'onglet |
|---|---|---|
QStyleOptionTab::Beginning | 0 | L'onglet est le premier onglet de la barre d'onglets. |
QStyleOptionTab::Middle | 1 | L'onglet n'est ni le premier ni le dernier onglet de la barre d'onglets. |
QStyleOptionTab::End | 2 | L'onglet est le dernier onglet de la barre d'onglets. |
QStyleOptionTab::OnlyOneTab | 3 | L'onglet est à la fois le premier et le dernier onglet de la barre d'onglets. |
QStyleOptionTab::Moving (since Qt 6.6) | 4 | L'onglet est déplacé par un glissement de souris ou une animation. |
Voir également position.
Documentation des fonctions membres
QStyleOptionTab::QStyleOptionTab()
Construit un objet QStyleOptionTab, en initialisant les variables membres à leurs valeurs par défaut.
QStyleOptionTab::QStyleOptionTab(const QStyleOptionTab &other)
Construit une copie de l'option de style other.
Documentation des variables membres
QStyleOptionTab::CornerWidgets QStyleOptionTab::cornerWidgets
Cette variable contient une combinaison OR de valeurs CornerWidget indiquant les widgets d'angle de la barre d'onglets
La valeur par défaut est NoCornerWidgets.
Voir aussi 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 sans pixmap 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 des barres d'onglets.
Voir aussi QTabBar::iconSize().
QSize QStyleOptionTab::leftButtonSize
Cette variable contient la taille du widget de gauche de 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, c'est-à-dire 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 indique la première ligne. Actuellement, cette propriété ne peut avoir que la valeur 0.
QStyleOptionTab::SelectedPosition QStyleOptionTab::selectedPosition
Cette variable contient la position de l'onglet sélectionné par rapport à cet onglet
La valeur par défaut est NotAdjacent, c'est-à-dire que l'onglet n'est pas adjacent à un onglet sélectionné et n'est pas non plus l'onglet sélectionné.
QTabBar::Shape QStyleOptionTab::shape
Cette variable contient la forme de l'onglet utilisée pour dessiner l'onglet ; par défaut QTabBar::RoundedNorth.
Voir aussi QTabBar::Shape.
int QStyleOptionTab::tabIndex
Cette variable contient l'index de l'onglet représenté.
La valeur par défaut est -1, c'est-à-dire un onglet qui ne se trouve pas sur 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.
