Sur cette page

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.

ConstanteValeurDescription
QStyleOptionToolButton::TypeSO_ToolButtonType 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.

ConstanteValeurDescription de l'option
QStyleOptionToolButton::Version11

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.

ConstanteValeurDescription
QStyleOptionToolButton::None0x00Bouton d'outil normal.
QStyleOptionToolButton::Arrow0x01Le bouton d'outil est une flèche.
QStyleOptionToolButton::Menu0x04Le bouton d'outil comporte un menu.
QStyleOptionToolButton::PopupDelay0x08L'affichage du menu est retardé.
QStyleOptionToolButton::HasMenu0x10Le bouton possède un menu contextuel.
QStyleOptionToolButton::MenuButtonPopupMenuLe 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.