QStyleOptionMenuItem Class
La classe QStyleOptionMenuItem est utilisée pour décrire les paramètres nécessaires à l'affichage d'un élément de menu. Plus d'informations...
| En-tête : | #include <QStyleOptionMenuItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite : | QStyleOption |
| Hérité par : |
Types publics
| enum | CheckType { NotCheckable, Exclusive, NonExclusive } |
| enum | MenuItemType { Normal, DefaultItem, Separator, SubMenu, Scroller, …, EmptyArea } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
Fonctions publiques
| QStyleOptionMenuItem() | |
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) |
Variables publiques
| QStyleOptionMenuItem::CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| QStyleOptionMenuItem::MenuItemType | menuItemType |
| QRect | menuRect |
| int | reservedShortcutWidth |
| QString | text |
Description détaillée
QStyleOptionMenuItem contient toutes les informations dont les fonctions QStyle ont besoin pour dessiner les éléments de menu de QMenu. Il est également utilisé pour dessiner d'autres widgets liés au menu.
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.
Documentation sur les types de membres
enum QStyleOptionMenuItem::CheckType
Cette énumération est utilisée pour indiquer si une coche doit être dessinée pour l'élément, ou même si elle doit être dessinée tout court.
| Constante | Valeur | Description de l'élément |
|---|---|---|
QStyleOptionMenuItem::NotCheckable | 0 | L'élément n'est pas vérifiable. |
QStyleOptionMenuItem::Exclusive | 1 | L'élément est un élément à cocher exclusif (comme un bouton radio). |
QStyleOptionMenuItem::NonExclusive | 2 | L'élément est un élément à cocher non exclusif (comme une case à cocher). |
Voir également checkType, QAction::checkable, QAction::checked, et QActionGroup::exclusionPolicy.
enum QStyleOptionMenuItem::MenuItemType
Cette énumération indique le type d'élément de menu décrit par la structure.
| Constante | Valeur | Description de l'élément de menu |
|---|---|---|
QStyleOptionMenuItem::Normal | 0 | Un élément de menu normal. |
QStyleOptionMenuItem::DefaultItem | 1 | Un élément de menu qui est l'action par défaut telle que spécifiée par QMenu::defaultAction(). |
QStyleOptionMenuItem::Separator | 2 | Séparateur de menu. |
QStyleOptionMenuItem::SubMenu | 3 | Indique que l'élément de menu pointe vers un sous-menu. |
QStyleOptionMenuItem::Scroller | 4 | Défilement d'un menu contextuel (actuellement utilisé uniquement sous macOS). |
QStyleOptionMenuItem::TearOff | 5 | Une poignée d'arrachage pour le menu. |
QStyleOptionMenuItem::Margin | 6 | Déclassé et non utilisé. La marge du menu. |
QStyleOptionMenuItem::EmptyArea | 7 | La zone vide du menu. |
Voir aussi menuItemType.
enum QStyleOptionMenuItem::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 |
|---|---|---|
QStyleOptionMenuItem::Type | SO_MenuItem | Type d'option de style fournie (SO_MenuItem 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 QStyleOptionMenuItem::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 |
|---|---|---|
QStyleOptionMenuItem::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 aussi StyleOptionType.
Documentation des fonctions membres
QStyleOptionMenuItem::QStyleOptionMenuItem()
Construit un QStyleOptionMenuItem, en initialisant les variables membres à leurs valeurs par défaut.
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
Construit une copie de l'option de style other.
Documentation des variables membres
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
Cette variable contient le type de coche de l'élément de menu
La valeur par défaut est NotCheckable.
Voir aussi CheckType.
bool QStyleOptionMenuItem::checked
Cette variable indique si l'élément de menu est coché ou non
La valeur par défaut est false.
QFont QStyleOptionMenuItem::font
Cette variable contient la police utilisée pour le texte de l'élément de menu
Il s'agit de la police à utiliser pour dessiner le texte du menu moins le raccourci. Le raccourci est généralement dessiné avec la police du peintre. Par défaut, la police par défaut de l'application est utilisée.
QIcon QStyleOptionMenuItem::icon
Cette variable contient l'icône de l'élément de menu
La valeur par défaut est une icône vide, c'est-à-dire une icône sans pixmap ni nom de fichier.
int QStyleOptionMenuItem::maxIconWidth
Cette variable contient la largeur maximale de l'icône de l'élément de menu
Cette valeur peut être utilisée pour dessiner l'icône au bon endroit ou pour aligner correctement les éléments. La variable doit être définie, que l'élément de menu ait ou non une icône. La valeur par défaut est 0.
bool QStyleOptionMenuItem::menuHasCheckableItems
Cette variable indique si le menu dans son ensemble comporte des éléments vérifiables ou non
La valeur par défaut est true (vrai).
Si cette option est fixée à false, le menu ne comporte pas d'éléments à cocher. Cela permet aux styles d'interface graphique d'économiser de l'espace horizontal qui serait normalement utilisé pour la colonne de contrôle.
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
Cette variable contient le type d'élément de menu
La valeur par défaut est Normal.
Voir aussi MenuItemType.
QRect QStyleOptionMenuItem::menuRect
Cette variable contient le rectangle pour l'ensemble du menu
La valeur par défaut est un rectangle nul, c'est-à-dire un rectangle dont la largeur et la hauteur sont fixées à 0.
int QStyleOptionMenuItem::reservedShortcutWidth
Cette variable contient la largeur réservée pour le raccourci de l'élément de menu
QMenu la fixe à la largeur occupée par le raccourci le plus large parmi tous les éléments visibles du menu.
La valeur par défaut est 0.
QString QStyleOptionMenuItem::text
Cette variable contient le texte de l'élément de menu
Notez que le format du texte est le suivant : "Texte du menu\tRaccourci".
Si l'élément de menu n'a pas de raccourci, la variable contiendra simplement le texte de l'élément de menu. La valeur par défaut est une chaîne vide.
© 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.
