QStyleOptionMenuItem Class
Die Klasse „QStyleOptionMenuItem“ dient dazu, die für die Darstellung eines Menüelements erforderlichen Parameter zu beschreiben. Mehr...
| Header: | #include <QStyleOptionMenuItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QStyleOption |
| Vererbt an: |
Öffentliche Typen
| enum | CheckType { NotCheckable, Exclusive, NonExclusive } |
| enum | MenuItemType { Normal, DefaultItem, Separator, SubMenu, Scroller, …, EmptyArea } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
Öffentliche Funktionen
| QStyleOptionMenuItem() | |
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) | |
| QStyleOptionMenuItem & | operator=(const QStyleOptionMenuItem &) |
Öffentliche Variablen
| QStyleOptionMenuItem::CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| QStyleOptionMenuItem::MenuItemType | menuItemType |
| QRect | menuRect |
| int | reservedShortcutWidth |
| QString | text |
Ausführliche Beschreibung
QStyleOptionMenuItem enthält alle Informationen, die die Funktionen von „ QStyle “ benötigen, um die Menüelemente aus „ QMenu “ zu zeichnen. Es wird auch zum Zeichnen anderer menübezogener Widgets verwendet.
Aus Leistungsgründen gibt es nur wenige Mitgliedsfunktionen, und der Zugriff auf die Mitgliedsvariablen erfolgt direkt (d. h. über den Operator ` . ` oder ` -> `). Dadurch sind die Strukturen einfach zu verwenden, und es wird deutlich, dass es sich lediglich um Parameter handelt, die von den Stilfunktionen verwendet werden.
Siehe auch QStyleOption.
Dokumentation zu Mitgliedstypen
enum QStyleOptionMenuItem::CheckType
Diese Enumeration dient dazu, anzugeben, ob für das Element ein Häkchen gezeichnet werden soll oder nicht, bzw. ob überhaupt ein Häkchen gezeichnet werden soll.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionMenuItem::NotCheckable | 0 | Das Element kann nicht markiert werden. |
QStyleOptionMenuItem::Exclusive | 1 | Das Element ist ein exklusives Kontrollelement (wie ein Optionsfeld). |
QStyleOptionMenuItem::NonExclusive | 2 | Das Element ist ein nicht exklusives Kontrollelement (wie ein Kontrollkästchen). |
Siehe auch checkType, QAction::checkable, QAction::checked und QActionGroup::exclusionPolicy.
enum QStyleOptionMenuItem::MenuItemType
Diese Enumeration gibt die Art des Menüpunkts an, den die Struktur beschreibt.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionMenuItem::Normal | 0 | Ein normales Menüelement. |
QStyleOptionMenuItem::DefaultItem | 1 | Ein Menüpunkt, der die Standardaktion darstellt, wie sie mit ` QMenu::defaultAction()` festgelegt wurde. |
QStyleOptionMenuItem::Separator | 2 | Ein Menütrennzeichen. |
QStyleOptionMenuItem::SubMenu | 3 | Gibt an, dass der Menüpunkt auf ein Untermenü verweist. |
QStyleOptionMenuItem::Scroller | 4 | Ein Popup-Menü-Bildlaufbalken (derzeit nur unter macOS verwendet). |
QStyleOptionMenuItem::TearOff | 5 | Ein Abreißgriff für das Menü. |
QStyleOptionMenuItem::Margin | 6 | Veraltet und wird nicht verwendet. Der Rand des Menüs. |
QStyleOptionMenuItem::EmptyArea | TearOff + 2 | Der leere Bereich des Menüs. |
Siehe auch menuItemType.
enum QStyleOptionMenuItem::StyleOptionType
Diese Enumeration dient zur Speicherung von Informationen über den Typ der Stiloption und wird für jede Unterklasse von „ QStyleOption “ definiert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionMenuItem::Type | SO_MenuItem | Der Typ der bereitgestellten Stiloption (SO_MenuItem für diese Klasse). |
Der Typ wird intern von „ QStyleOption “, seinen Unterklassen und „ qstyleoption_cast()“ verwendet, um den Typ der Stiloption zu bestimmen. Im Allgemeinen müssen Sie sich darüber keine Gedanken machen, es sei denn, Sie möchten eine eigene Unterklasse von „ QStyleOption “ und eigene Stile erstellen.
Siehe auch StyleOptionVersion.
enum QStyleOptionMenuItem::StyleOptionVersion
Diese Enumeration dient zur Speicherung von Informationen über die Version der Stiloption und ist für jede Unterklasse von ` QStyleOption ` definiert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionMenuItem::Version | 1 | 1 |
Die Version wird von Unterklassen von ` QStyleOption ` verwendet, um Erweiterungen zu implementieren, ohne die Kompatibilität zu beeinträchtigen. Wenn Sie ` qstyleoption_cast()` verwenden, müssen Sie dies normalerweise nicht überprüfen.
Siehe auch StyleOptionType.
Dokumentation der Mitgliedsfunktionen
QStyleOptionMenuItem::QStyleOptionMenuItem()
Erstellt ein `QStyleOptionMenuItem` und initialisiert die Mitgliedsvariablen mit ihren Standardwerten.
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
Erstellt eine Kopie der Stiloption „ other “.
[noexcept default] QStyleOptionMenuItem &QStyleOptionMenuItem::operator=(const QStyleOptionMenuItem &)
other Weist dieser Instanz von „ QStyleOptionMenuItem “ den Wert „ “ zu.
Dokumentation zu Member-Variablen
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
Diese Variable enthält den Typ des Häkchens des Menüelements
Der Standardwert ist „ NotCheckable “.
Siehe auch „ CheckType “.
bool QStyleOptionMenuItem::checked
Diese Variable gibt an, ob das Menüelement markiert ist oder nicht
Der Standardwert ist „false“.
QFont QStyleOptionMenuItem::font
Diese Variable enthält die Schriftart, die für den Text des Menüelements verwendet wird
Dies ist die Schriftart, die zum Zeichnen des Menütextes ohne die Tastenkombination verwendet werden soll. Die Tastenkombination wird in der Regel mit der Schriftart des „Painters“ dargestellt. Standardmäßig wird die Standardschriftart der Anwendung verwendet.
QIcon QStyleOptionMenuItem::icon
Diese Variable enthält das Symbol für den Menüpunkt
Der Standardwert ist ein leeres Symbol, d. h. ein Symbol, das weder über eine Pixmap noch über einen Dateinamen verfügt.
int QStyleOptionMenuItem::maxIconWidth
Diese Variable enthält die maximale Breite des Symbols für den Menüpunkt
Dies kann verwendet werden, um das Symbol an der richtigen Stelle zu zeichnen oder Menüpunkte korrekt auszurichten. Die Variable muss unabhängig davon gesetzt werden, ob der Menüpunkt ein Symbol hat oder nicht. Der Standardwert ist 0.
bool QStyleOptionMenuItem::menuHasCheckableItems
Diese Variable gibt an, ob das Menü insgesamt ankreuzbare Einträge enthält oder nicht
Der Standardwert ist „true“.
Wenn diese Option auf „false“ gesetzt ist, enthält das Menü keine ankreuzbaren Elemente. Dadurch können GUI-Stile etwas Platz in der Breite einsparen, der normalerweise für die Kontrollspalte benötigt würde.
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
Diese Variable enthält den Typ des Menüelements
Der Standardwert ist „ Normal “.
Siehe auch „ MenuItemType “.
QRect QStyleOptionMenuItem::menuRect
Diese Variable enthält das Rechteck für das gesamte Menü
Der Standardwert ist ein Null-Rechteck, d. h. ein Rechteck, bei dem sowohl die Breite als auch die Höhe auf 0 gesetzt sind.
int QStyleOptionMenuItem::reservedShortcutWidth
Diese Variable enthält die für die Verknüpfung des Menüpunkts reservierte Breite
QMenu setzt sie auf die Breite, die der breiteste Shortcut unter allen sichtbaren Elementen im Menü einnimmt.
Der Standardwert ist 0.
QString QStyleOptionMenuItem::text
Diese Variable enthält den Text für den Menüpunkt
Beachte, dass das Textformat in etwa so aussieht: „Menütext\tTastenkombination“.
Wenn der Menüpunkt keinen Tastenkürzel hat, enthält er lediglich den Text des Menüpunkts. Der Standardwert ist eine leere Zeichenkette.
© 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.
