QStyleOptionMenuItem Class
La classe QStyleOptionMenuItem sert à définir les paramètres nécessaires au tracé d'un élément de menu. En savoir plus...
| En-tête : | #include <QStyleOptionMenuItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QStyleOption |
| Hérédité : |
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) | |
| QStyleOptionMenuItem & | operator=(const QStyleOptionMenuItem &) |
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 d'QStyle ont besoin pour dessiner les éléments de menu à partir de QMenu. Il est également utilisé pour dessiner d'autres widgets liés au menu.
Pour des raisons de performances, il comporte 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 QStyleOptionMenuItem::CheckType
Cette énumération sert à indiquer si une coche doit être affichée pour l'élément, ou même si celle-ci doit être affichée tout court.
| Constante | Valeur | Description |
|---|---|---|
QStyleOptionMenuItem::NotCheckable | 0 | L'élément ne peut pas être coché. |
QStyleOptionMenuItem::Exclusive | 1 | L'élément est un élément à cocher exclusif (comme un bouton radio). |
QStyleOptionMenuItem::NonExclusive | 2 | Cet é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 |
|---|---|---|
QStyleOptionMenuItem::Normal | 0 | Un élément de menu normal. |
QStyleOptionMenuItem::DefaultItem | 1 | Un élément de menu correspondant à l'action par défaut, telle que spécifiée par la fonction ` QMenu::defaultAction()`. |
QStyleOptionMenuItem::Separator | 2 | Un séparateur de menu. |
QStyleOptionMenuItem::SubMenu | 3 | Indique que l'élément de menu pointe vers un sous-menu. |
QStyleOptionMenuItem::Scroller | 4 | Une barre de défilement du menu contextuel (actuellement utilisée uniquement sous macOS). |
QStyleOptionMenuItem::TearOff | 5 | Une poignée de détachement pour le menu. |
QStyleOptionMenuItem::Margin | 6 | Obsolète et non utilisé. La marge du menu. |
QStyleOptionMenuItem::EmptyArea | TearOff + 2 | La zone vide du menu. |
Voir aussi menuItemType.
enum QStyleOptionMenuItem::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 |
|---|---|---|
QStyleOptionMenuItem::Type | SO_MenuItem | Le type de l'option de style fournie (SO_MenuItem 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 QStyleOptionMenuItem::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 |
|---|---|---|
QStyleOptionMenuItem::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.
Documentation sur les fonctions membres
QStyleOptionMenuItem::QStyleOptionMenuItem()
Crée un objet `QStyleOptionMenuItem` en initialisant ses variables membres à leurs valeurs par défaut.
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
Crée une copie de l'option de style « other ».
[noexcept default] QStyleOptionMenuItem &QStyleOptionMenuItem::operator=(const QStyleOptionMenuItem &)
Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionMenuItem `.
Documentation sur les 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 également 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 des éléments du menu
Il s'agit de la police qui doit être utilisée pour afficher le texte du menu, à l'exception du raccourci. Le raccourci est généralement affiché en utilisant la police du peintre. Par défaut, c'est la police par défaut de l'application qui 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 ne comportant ni image ni nom de fichier.
int QStyleOptionMenuItem::maxIconWidth
Cette variable contient la largeur maximale de l'icône associée à l'élément de menu
Elle 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 comporte 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 ou non des éléments pouvant être cochés
La valeur par défaut est « true ».
Si cette option est définie sur « false », le menu ne comporte alors aucun élément pouvant être coché. Cela permet aux styles d'interface graphique de gagner de l'espace horizontal qui serait normalement utilisé pour la colonne de sélection.
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
Cette variable contient le type de l'élément de menu
La valeur par défaut est « Normal ».
Voir également MenuItemType.
QRect QStyleOptionMenuItem::menuRect
Cette variable contient le rectangle correspondant à 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 toutes deux définies sur 0.
int QStyleOptionMenuItem::reservedShortcutWidth
Cette variable contient la largeur réservée au raccourci de l'élément de menu
QMenu la définit sur 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 similaire à celui-ci : « Texte du menu\tRaccourci ».
Si l'élément de menu ne dispose pas de raccourci, elle ne contiendra que 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.
