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 `.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionToolBar::Type | SO_ToolBar | Le 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 `.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionToolBar::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 QStyleOptionToolBar::ToolBarFeature
flags QStyleOptionToolBar::ToolBarFeatures
Cette énumération sert à indiquer si une barre d'outils est déplaçable ou non.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionToolBar::None | 0x0 | La barre d'outils ne peut pas être déplacée. Valeur par défaut. |
QStyleOptionToolBar::Movable | 0x1 | La 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

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.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionToolBar::Beginning | 0 | La 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::Middle | 1 | La 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::End | 2 | La 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::OnlyOne | 3 | Il 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.