QStyleOptionToolButton Class
La classe QStyleOptionToolButton est utilisée pour décrire les paramètres de dessin d'un bouton d'outil. Plus d'informations...
| En-tête : | #include <QStyleOptionToolButton> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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) |
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 QStyle ont besoin pour dessiner QToolButton.
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, QStyleOptionComplex, et QStyleOptionButton.
Documentation sur les types de membres
enum QStyleOptionToolButton::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 |
|---|---|---|
QStyleOptionToolButton::Type | SO_ToolButton | Type d'option de style fournie (SO_ToolButton 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 QStyleOptionToolButton::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 |
|---|---|---|
QStyleOptionToolButton::Version | 1 | 1 |
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 QStyleOptionToolButton::ToolButtonFeature
flags QStyleOptionToolButton::ToolButtonFeatures
Décrit les différentes caractéristiques qu'un bouton d'outil peut avoir.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionToolButton::None | 0x00 | Bouton d'outil normal. |
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 retardé. |
QStyleOptionToolButton::HasMenu | 0x10 | Le bouton possède 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 un typedef pour QFlags<ToolButtonFeature>. Il stocke une combinaison OU de valeurs ToolButtonFeatures.
Voir également features, QToolButton::toolButtonStyle() et QToolButton::popupMode().
Documentation des fonctions membres
QStyleOptionToolButton::QStyleOptionToolButton()
Construit un QStyleOptionToolButton, en initialisant les variables membres à leurs valeurs par défaut.
QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)
Construit une copie de l'option de style other.
Documentation des variables membres
Qt::ArrowType QStyleOptionToolButton::arrowType
Cette variable contient la direction de la flèche pour le bouton de l'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 OR des caractéristiques du bouton d'outil
La valeur par défaut est None.
Voir aussi ToolButtonFeature.
QFont QStyleOptionToolButton::font
Cette variable contient la police utilisée pour le texte
Cette valeur n'est utilisée que si toolButtonStyle est Qt::ToolButtonTextUnderIcon, Qt::ToolButtonTextBesideIcon, ou Qt::ToolButtonTextOnly. Par défaut, c'est la police par défaut de l'application qui est utilisée.
QIcon QStyleOptionToolButton::icon
Cette variable contient l'icône du bouton de l'outil
La valeur par défaut est une icône vide, c'est-à-dire une icône sans pixmap ni nom de fichier.
Voir aussi 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 un point nul, 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 toolButtonStyle est 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 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.