Sur cette page

QStyleOptionToolBar Class

La classe QStyleOptionToolBar sert à définir les paramètres de dessin d'une barre d'outils. En savoir plus...

En-tête : #include <QStyleOptionToolBar>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QStyleOption

Types publics

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }
enum ToolBarFeature { None, Movable }
flags ToolBarFeatures
enum ToolBarPosition { Beginning, Middle, End, OnlyOne }

Fonctions publiques

QStyleOptionToolBar()
QStyleOptionToolBar(const QStyleOptionToolBar &other)
QStyleOptionToolBar &operator=(const QStyleOptionToolBar &)

Variables publiques

QStyleOptionToolBar::ToolBarFeatures features
int lineWidth
int midLineWidth
QStyleOptionToolBar::ToolBarPosition positionOfLine
QStyleOptionToolBar::ToolBarPosition positionWithinLine
Qt::ToolBarArea toolBarArea

Description détaillée

QStyleOptionToolBar contient toutes les informations dont les fonctions d'QStyle ont besoin pour dessiner QToolBar.

La classe QStyleOptionToolBar contient l'lineWidth et l'midLineWidth nécessaires au dessin du widget. Elle stocke également des informations sur l'area dans laquelle la barre d'outils doit se trouver, si elle est déplaçable ou non, la position que doit occuper la ligne de la barre d'outils (positionOfLine) et la position de la barre d'outils au sein de cette ligne (positionWithinLine).

De plus, la classe fournit deux énumérations : l’énumération « ToolBarFeature » sert à indiquer si une barre d’outils est déplaçable ou non, et l’énumération « ToolBarPosition » sert à décrire la position d’une ligne de la barre d’outils, ainsi que la position de la barre d’outils au sein de cette ligne.

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.

Documentation sur les types membres

enum QStyleOptionToolBar::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 `.

ConstanteValeurDescription
QStyleOptionToolBar::TypeSO_ToolBarLe type de l'option de style fournie (SO_ToolBar 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 QStyleOptionToolBar::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 `.

ConstanteValeurDescription
QStyleOptionToolBar::Version11

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 QStyleOptionToolBar::ToolBarFeature
flags QStyleOptionToolBar::ToolBarFeatures

Cette énumération sert à indiquer si une barre d'outils est déplaçable ou non.

ConstanteValeurDescription
QStyleOptionToolBar::None0x0La barre d'outils ne peut pas être déplacée. Valeur par défaut.
QStyleOptionToolBar::Movable0x1La barre d'outils est déplaçable, et une poignée apparaît lorsque l'on survole le bord de la barre d'outils avec le curseur.

Le type ToolBarFeatures est un typedef pour QFlags<ToolBarFeature>. Il stocke une combinaison OR de valeurs ToolBarFeature.

Voir également features et QToolBar::isMovable().

enum QStyleOptionToolBar::ToolBarPosition

Schéma représentant la ligne de la barre d'outils et les positions par rapport à cette ligne

Cette énumération sert à décrire la position d'une ligne de barre d'outils, ainsi que la position de la barre d'outils au sein de cette ligne.

L'ordre des positions au sein d'une ligne commence par le haut dans le cas d'une ligne verticale, et par la gauche dans le cas d'une ligne horizontale. L'ordre des positions pour les lignes est toujours défini à partir des bords du widget parent.

ConstanteValeurDescription
QStyleOptionToolBar::Beginning0La barre d'outils est située au début de la ligne, ou la ligne de la barre d'outils est la première d'une série de lignes. Il ne peut y avoir qu'une seule barre d'outils (et une seule ligne) avec cette position.
QStyleOptionToolBar::Middle1La barre d'outils est située au milieu de la ligne, ou la ligne de la barre d'outils se trouve au milieu de plusieurs lignes. Il peut y avoir plusieurs barres d'outils (et lignes) occupant cette position.
QStyleOptionToolBar::End2La barre d'outils est située à la fin de la ligne, ou la ligne de la barre d'outils est la dernière d'une série de lignes. Il ne peut y avoir qu'une seule barre d'outils (et une seule ligne) avec cette position.
QStyleOptionToolBar::OnlyOne3Il n’y a qu’une seule barre d’outils ou ligne. Il s’agit de la valeur par défaut des variables positionOfLine et positionWithinLine.

Voir également positionWithinLine et positionOfLine.

Documentation sur les fonctions membres

QStyleOptionToolBar::QStyleOptionToolBar()

Crée un objet `QStyleOptionToolBar` en initialisant les variables membres à leurs valeurs par défaut.

QStyleOptionToolBar::QStyleOptionToolBar(const QStyleOptionToolBar &other)

Crée une copie de l'option de style « other ».

[noexcept default] QStyleOptionToolBar &QStyleOptionToolBar::operator=(const QStyleOptionToolBar &)

Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionToolBar `.

Documentation sur les variables membres

QStyleOptionToolBar::ToolBarFeatures QStyleOptionToolBar::features

Cette variable indique si la barre d'outils est déplaçable ou non.

La valeur par défaut est « None ».

int QStyleOptionToolBar::lineWidth

Cette variable définit la largeur de la ligne utilisée pour dessiner la barre d'outils.

La valeur par défaut est 0.

int QStyleOptionToolBar::midLineWidth

Cette variable contient la largeur de la ligne médiane utilisée pour le tracé de la barre d'outils.

La valeur par défaut est 0.

QStyleOptionToolBar::ToolBarPosition QStyleOptionToolBar::positionOfLine

Cette variable contient la position de la ligne de la barre d'outils.

La valeur par défaut est QStyleOptionToolBar::OnlyOne.

QStyleOptionToolBar::ToolBarPosition QStyleOptionToolBar::positionWithinLine

Cette variable indique la position de la barre d'outils au sein d'une ligne.

La valeur par défaut est QStyleOptionToolBar::OnlyOne.

Qt::ToolBarArea QStyleOptionToolBar::toolBarArea

Cette variable contient l'emplacement où la barre d'outils doit être affichée.

La valeur par défaut est Qt::TopToolBarArea.

Voir également Qt::ToolBarArea.

© 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.