QStyleOptionToolButton Class
La classe `QStyleOptionToolButton` sert à définir les paramètres de dessin d'un bouton d'outil. En savoir plus...
| En-tête : | #include <QStyleOptionToolButton> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QStyleOptionComplex |
Types publics
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ToolButtonFeature { None, Arrow, Menu, PopupDelay, HasMenu, MenuButtonPopup } |
| flags | ToolButtonFeatures |
Fonctions publiques
| QStyleOptionToolButton() | |
| QStyleOptionToolButton(const QStyleOptionToolButton &other) | |
| QStyleOptionToolButton & | operator=(const QStyleOptionToolButton &) |
Variables publiques
| Qt::ArrowType | arrowType |
| QStyleOptionToolButton::ToolButtonFeatures | features |
| QFont | font |
| QIcon | icon |
| QSize | iconSize |
| QPoint | pos |
| QString | text |
| Qt::ToolButtonStyle | toolButtonStyle |
Description détaillée
QStyleOptionToolButton contient toutes les informations dont les fonctions d'QStyle ont besoin pour dessiner QToolButton.
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, QStyleOptionComplex et QStyleOptionButton.
Documentation sur les types de membres
enum QStyleOptionToolButton::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 |
|---|---|---|
QStyleOptionToolButton::Type | SO_ToolButton | Le type de l'option de style fournie (SO_ToolButton 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 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.
Voir également StyleOptionVersion.
enum QStyleOptionToolButton::StyleOptionVersion
Cette énumération sert à stocker des informations sur la version de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionToolButton::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.
enum QStyleOptionToolButton::ToolButtonFeature
flags QStyleOptionToolButton::ToolButtonFeatures
Décrit les différentes fonctionnalités qu'un bouton d'outil peut offrir.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionToolButton::None | 0x00 | Un bouton d'outil standard. |
QStyleOptionToolButton::Arrow | 0x01 | Le bouton d'outil est une flèche. |
QStyleOptionToolButton::Menu | 0x04 | Le bouton d'outil comporte un menu. |
QStyleOptionToolButton::PopupDelay | 0x08 | L'affichage du menu est différé. |
QStyleOptionToolButton::HasMenu | 0x10 | Le bouton comporte un menu contextuel. |
QStyleOptionToolButton::MenuButtonPopup | Menu | Le bouton doit afficher une flèche pour indiquer la présence d'un menu. |
Le type `ToolButtonFeatures` est une définition de type (`typedef`) pour ` QFlags<ToolButtonFeature>`. Il stocke une combinaison « OU » de valeurs `ToolButtonFeature`.
Voir également features, QToolButton::toolButtonStyle() et QToolButton::popupMode().
Documentation des fonctions membres
QStyleOptionToolButton::QStyleOptionToolButton()
Crée un objet `QStyleOptionToolButton` en initialisant ses variables membres à leurs valeurs par défaut.
QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)
Crée une copie de l'option de style « other ».
[noexcept default] QStyleOptionToolButton &QStyleOptionToolButton::operator=(const QStyleOptionToolButton &)
Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionToolButton `.
Documentation sur les variables membres
Qt::ArrowType QStyleOptionToolButton::arrowType
Cette variable détermine l'orientation de la flèche du bouton d'outil
Cette valeur n'est utilisée que si features inclut Arrow. La valeur par défaut est Qt::DownArrow.
QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton::features
Cette variable contient une combinaison « OU » des fonctionnalités du bouton d'outil
La valeur par défaut est None.
Voir également ToolButtonFeature.
QFont QStyleOptionToolButton::font
Cette variable contient la police utilisée pour le texte
Cette valeur n'est utilisée que si la propriété « toolButtonStyle » est définie sur « Qt::ToolButtonTextUnderIcon », « Qt::ToolButtonTextBesideIcon » ou « Qt::ToolButtonTextOnly ». Par défaut, la police par défaut de l'application est utilisée.
QIcon QStyleOptionToolButton::icon
Cette variable contient l'icône du bouton d'outil
La valeur par défaut est une icône vide, c'est-à-dire une icône ne comportant ni image ni nom de fichier.
Voir également iconSize.
QSize QStyleOptionToolButton::iconSize
Cette variable contient la taille de l'icône du bouton d'outil
La valeur par défaut est QSize(-1, -1), c'est-à-dire une taille non valide.
QPoint QStyleOptionToolButton::pos
Cette variable contient la position du bouton de l'outil
La valeur par défaut est le point zéro, c'est-à-dire (0, 0)
QString QStyleOptionToolButton::text
Cette variable contient le texte du bouton de l'outil
Cette valeur n'est utilisée que si la variable « toolButtonStyle » prend l'une des valeurs suivantes : Qt::ToolButtonTextUnderIcon, Qt::ToolButtonTextBesideIcon ou Qt::ToolButtonTextOnly. La valeur par défaut est une chaîne vide.
Qt::ToolButtonStyle QStyleOptionToolButton::toolButtonStyle
Cette variable contient une valeur de type « Qt::ToolButtonStyle » décrivant l'apparence du bouton de l'outil
La valeur par défaut est ` Qt::ToolButtonIconOnly`.
Voir aussi QToolButton::toolButtonStyle().
© 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.
