QStyleOptionMenuItem Class
Die Klasse QStyleOptionMenuItem wird verwendet, um die Parameter zu beschreiben, die zum Zeichnen eines Menüeintrags erforderlich sind. Mehr...
| Kopfzeile: | #include <QStyleOptionMenuItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbt: | QStyleOption |
Ö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) |
Öffentliche Variablen
| QStyleOptionMenuItem::CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| QStyleOptionMenuItem::MenuItemType | menuItemType |
| QRect | menuRect |
| int | reservedShortcutWidth |
| QString | text |
Detaillierte Beschreibung
QStyleOptionMenuItem enthält alle Informationen, die die Funktionen von QStyle benötigen, um die Menüpunkte von 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. mit dem . oder -> Operator). Dadurch sind die Strukturen einfach zu verwenden und es wird betont, dass es sich lediglich um Parameter handelt, die von den Stilfunktionen verwendet werden.
Siehe auch QStyleOption.
Dokumentation der Mitgliedstypen
enum QStyleOptionMenuItem::CheckType
Diese Aufzählung wird verwendet, um anzugeben, ob für das Element ein Häkchen gesetzt werden soll oder nicht, oder ob es überhaupt gesetzt werden soll.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionMenuItem::NotCheckable | 0 | Das Element ist nicht ankreuzbar. |
QStyleOptionMenuItem::Exclusive | 1 | Das Item ist ein exklusives Check-Item (wie ein Radio-Button). |
QStyleOptionMenuItem::NonExclusive | 2 | Das Element ist ein nicht-exklusives Ankreuzelement (wie ein Kontrollkästchen). |
Siehe auch checkType, QAction::checkable, QAction::checked, und QActionGroup::exclusionPolicy.
enum QStyleOptionMenuItem::MenuItemType
Diese Aufzählung gibt den Typ des Menüpunkts an, den die Struktur beschreibt.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionMenuItem::Normal | 0 | Ein normaler Menüpunkt. |
QStyleOptionMenuItem::DefaultItem | 1 | Ein Menüpunkt, der die Standardaktion ist, wie mit QMenu::defaultAction() angegeben. |
QStyleOptionMenuItem::Separator | 2 | Ein Menütrennzeichen. |
QStyleOptionMenuItem::SubMenu | 3 | Zeigt an, dass der Menüpunkt auf ein Untermenü verweist. |
QStyleOptionMenuItem::Scroller | 4 | Ein Popup-Menü-Scroller (wird derzeit nur unter macOS verwendet). |
QStyleOptionMenuItem::TearOff | 5 | Ein Abreißgriff für das Menü. |
QStyleOptionMenuItem::Margin | 6 | Der Rand des Menüs. |
QStyleOptionMenuItem::EmptyArea | 7 | Der leere Bereich des Menüs. |
Siehe auch menuItemType.
enum QStyleOptionMenuItem::StyleOptionType
Diese Aufzählung wird verwendet, um Informationen über den Typ der Stiloption zu speichern, und ist für jede Unterklasse von QStyleOption definiert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionMenuItem::Type | SO_MenuItem | Der Typ der angebotenen 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 wollen Ihre eigene QStyleOption Unterklasse und Ihre eigenen Stile erstellen.
Siehe auch StyleOptionVersion.
enum QStyleOptionMenuItem::StyleOptionVersion
Diese Aufzählung wird verwendet, um Informationen über die Version der Stiloption zu speichern, und ist für jede Unterklasse von QStyleOption definiert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QStyleOptionMenuItem::Version | 1 | 1 |
Die Version wird von QStyleOption Unterklassen verwendet, um Erweiterungen zu implementieren, ohne die Kompatibilität zu verletzen. Wenn Sie qstyleoption_cast() verwenden, brauchen Sie sie normalerweise nicht zu überprüfen.
Siehe auch StyleOptionType.
Dokumentation der Mitgliedsfunktionen
QStyleOptionMenuItem::QStyleOptionMenuItem()
Konstruiert ein QStyleOptionMenuItem und initialisiert die Variablen der Mitglieder auf ihre Standardwerte.
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
Konstruiert eine Kopie der Stiloption other.
Dokumentation der Mitgliedsvariablen
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
Diese Variable enthält den Typ des Häkchens für den Menüpunkt
Der Standardwert ist NotCheckable.
Siehe auch CheckType.
bool QStyleOptionMenuItem::checked
Diese Variable gibt an, ob der Menüpunkt markiert ist oder nicht
Der Standardwert ist false.
QFont QStyleOptionMenuItem::font
Diese Variable enthält die Schriftart, die für den Text des Menüpunkts verwendet wird
Dies ist die Schriftart, die zum Zeichnen des Menütextes abzüglich des Shortcuts verwendet werden soll. Die Verknüpfung wird normalerweise mit der Schriftart des Malers gezeichnet. 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 ohne Pixmap und ohne Dateinamen.
int QStyleOptionMenuItem::maxIconWidth
Diese Variable enthält die maximale Symbolbreite für das Symbol im Menüpunkt
Dies kann verwendet werden, um das Icon an die richtige Stelle zu zeichnen oder die Elemente richtig 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ü als Ganzes ankreuzbare Einträge hat oder nicht
Der Standardwert ist true.
Wenn diese Option auf false gesetzt ist, hat das Menü keine ankreuzbaren Einträge. Dies ermöglicht es GUI-Styles, horizontalen Platz zu sparen, der normalerweise für die Ankreuzspalte verwendet würde.
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
Diese Variable enthält den Typ des Menüpunkts
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 reservierte Breite für die Verknüpfung des Menüeintrags
QMenu setzt sie auf die Breite, die die breiteste Verknüpfung aller sichtbaren Menüpunkte einnimmt.
Der Standardwert ist 0.
QString QStyleOptionMenuItem::text
Diese Variable enthält den Text für den Menüpunkt
Beachten Sie, dass das Textformat etwa so aussieht: "Menütext\tShortcut".
Wenn der Menüpunkt keinen Shortcut hat, enthält sie nur den Text des Menüpunkts. Der Standardwert ist eine leere Zeichenfolge.
© 2025 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.
