QAction Class

Eigenschaft Dokumentation

autoRepeat : bool

Diese Eigenschaft gibt an, ob die Aktion automatisch wiederholt werden kann.

Bei true wird die Aktion automatisch wiederholt, wenn die Tastenkombination gedrückt wird, vorausgesetzt, die automatische Wiederholung der Tastatur ist auf dem System aktiviert. Der Standardwert ist true.

Zugriffsfunktionen:

Benachrichtigungssignal:

checkable : bool

Diese Eigenschaft gibt an, ob die Aktion eine überprüfbare Aktion ist

Eine überprüfbare Aktion ist eine Aktion, die einen Ein/Aus-Status hat. In einem Textverarbeitungsprogramm kann z. B. die Schaltfläche "Fett" in der Symbolleiste entweder ein- oder ausgeschaltet sein. Eine Aktion, bei der es sich nicht um eine Umschaltaktion handelt, ist eine Befehlsaktion; eine Befehlsaktion wird einfach ausgeführt, z. B. Datei speichern. Standardmäßig ist diese Eigenschaft false.

In manchen Situationen sollte der Zustand einer Toggle-Aktion vom Zustand anderer Aktionen abhängen. Zum Beispiel schließen sich die Umschaltaktionen "Links ausrichten", "Zentrieren" und "Rechts ausrichten" gegenseitig aus. Um ein exklusives Umschalten zu erreichen, fügen Sie die entsprechenden Toggle-Aktionen zu einer QActionGroup mit der Eigenschaft QActionGroup::exclusive auf true gesetzt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch setChecked().

checked : bool

Diese Eigenschaft gibt an, ob die Aktion geprüft wird.

Nur überprüfbare Aktionen können überprüft werden. Standardmäßig ist dies false (die Aktion ist nicht angekreuzt).

Zugriffsfunktionen:

Melder-Signal:

Siehe auch checkable und toggled().

enabled : bool

Diese Eigenschaft gibt an, ob die Aktion aktiviert ist.

Deaktivierte Aktionen können vom Benutzer nicht ausgewählt werden. Sie verschwinden nicht aus den Menüs oder Symbolleisten, aber sie werden so angezeigt, dass sie nicht verfügbar sind. Sie können zum Beispiel nur in Grautönen angezeigt werden.

What's This? Die Hilfe zu deaktivierten Aktionen ist weiterhin verfügbar, sofern die Eigenschaft QAction::whatsThis gesetzt ist.

Eine Aktion wird deaktiviert, wenn alle Widgets, zu denen sie hinzugefügt wurde (mit QWidget::addAction()), deaktiviert oder nicht sichtbar sind. Wenn eine Aktion deaktiviert ist, ist es nicht möglich, sie über ihre Verknüpfung auszulösen.

Standardmäßig ist diese Eigenschaft true (Aktionen sind aktiviert).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch text.

font : QFont

Diese Eigenschaft enthält die Schriftart der Aktion

Die Eigenschaft Schriftart wird verwendet, um den auf QAction eingestellten Text darzustellen. Die Schriftart kann als Hinweis betrachtet werden, da sie je nach Anwendung und Stil nicht in allen Fällen herangezogen wird.

Standardmäßig enthält diese Eigenschaft die Standardschriftart der Anwendung.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch setText().

icon : QIcon

Diese Eigenschaft enthält das Symbol der Aktion

In Symbolleisten wird das Symbol als Schaltflächensymbol verwendet; in Menüs wird es links vom Menütext angezeigt, sofern QAction::iconVisibleInMenu true zurückgibt.

Es gibt kein Standardsymbol.

Wenn ein Null-Symbol (QIcon::isNull()) an diese Funktion übergeben wird, wird das Symbol der Aktion gelöscht.

Zugriffsfunktionen:

Benachrichtigungssignal:

iconText : QString

Diese Eigenschaft enthält den beschreibenden Symboltext der Aktion

Wenn QToolBar::toolButtonStyle auf einen Wert gesetzt ist, der die Anzeige von Text erlaubt, erscheint der in dieser Eigenschaft definierte Text als Beschriftung in der entsprechenden Werkzeugschaltfläche.

Er dient auch als Standardtext in Menüs und Tooltips, wenn die Aktion nicht mit setText() oder setToolTip() definiert wurde, und wird auch in Schaltflächen der Symbolleiste verwendet, wenn kein Symbol mit setIcon() definiert wurde.

Wenn der Icon-Text nicht explizit gesetzt ist, wird der normale Text der Aktion für den Icon-Text verwendet.

Standardmäßig enthält diese Eigenschaft eine leere Zeichenkette.

Zugriffsfunktionen:

Melder-Signal:

Siehe auch setToolTip() und setStatusTip().

iconVisibleInMenu : bool

Diese Eigenschaft legt fest, ob eine Aktion ein Symbol in einem Menü anzeigen soll oder nicht

In manchen Anwendungen kann es sinnvoll sein, Aktionen mit Symbolen in der Symbolleiste, aber nicht in Menüs zu haben. Bei "true" wird das Symbol (falls gültig) im Menü angezeigt, bei "false" wird es nicht angezeigt.

Die Standardeinstellung folgt der Einstellung des Attributs Qt::AA_DontShowIconsInMenus für die Anwendung. Die explizite Einstellung dieser Eigenschaft setzt das Vorhandensein (oder Fehlen) des Attributs außer Kraft.

Ein Beispiel:

QApplication app(argc, argv);
app.setAttribute(Qt::AA_DontShowIconsInMenus);  // Icons are *no longer shown* in menus
// ...
QAction *myAction = new QAction();
// ...
myAction->setIcon(SomeIcon);
myAction->setIconVisibleInMenu(true);   // Icon *will* be shown in menus for *this* action.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch icon und QCoreApplication::setAttribute().

menuRole : MenuRole

Diese Eigenschaft enthält die Menürolle der Aktion

Sie gibt an, welche Rolle die Aktion im Anwendungsmenü unter macOS einnimmt. Standardmäßig haben alle Aktionen die TextHeuristicRole, was bedeutet, dass die Aktion auf der Grundlage ihres Textes hinzugefügt wird (siehe QMenuBar für weitere Informationen).

Die Menürolle kann nur geändert werden, bevor die Aktionen in die Menüleiste unter macOS eingefügt werden (normalerweise kurz bevor das erste Anwendungsfenster angezeigt wird).

Zugriffsfunktionen:

Benachrichtigungssignal:

priority : Priority

Diese Eigenschaft enthält die Priorität der Aktion in der Benutzeroberfläche.

Diese Eigenschaft kann eingestellt werden, um anzugeben, wie die Aktion in der Benutzeroberfläche priorisiert werden soll.

Wenn z. B. für Symbolleisten der Modus Qt::ToolButtonTextBesideIcon eingestellt ist, werden bei Aktionen mit LowPriority die Textbeschriftungen nicht angezeigt.

Zugriffsfunktionen:

Benachrichtigungssignal:

shortcut : QKeySequence

Diese Eigenschaft enthält das primäre Tastenkürzel der Aktion

Gültige Tastenkombinationen für diese Eigenschaft finden Sie unter Qt::Key und Qt::Modifier. Es gibt keine Standardtaste für Tastenkombinationen.

Zugriffsfunktionen:

Benachrichtigungssignal:

shortcutContext : Qt::ShortcutContext

Diese Eigenschaft enthält den Kontext für die Abkürzung der Aktion

Gültige Werte für diese Eigenschaft finden Sie unter Qt::ShortcutContext. Der Standardwert ist Qt::WindowShortcut.

Zugriffsfunktionen:

Benachrichtigungssignal:

shortcutVisibleInContextMenu : bool

Diese Eigenschaft legt fest, ob eine Aktion eine Verknüpfung in einem Kontextmenü anzeigen soll oder nicht

In manchen Anwendungen kann es sinnvoll sein, Aktionen mit Shortcuts in Kontextmenüs zu haben. Bei true wird die Verknüpfung (falls gültig) angezeigt, wenn die Aktion über ein Kontextmenü angezeigt wird, bei false wird sie nicht angezeigt.

Der Standardwert folgt der Einstellung des Attributs Qt::AA_DontShowShortcutsInContextMenus für die Anwendung. Das explizite Setzen dieser Eigenschaft setzt das Attribut außer Kraft.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch shortcut und QCoreApplication::setAttribute().

statusTip : QString

Diese Eigenschaft enthält den Statustipp der Aktion

Der Statustipp wird in allen Statusleisten angezeigt, die vom übergeordneten Widget der Aktion bereitgestellt werden.

Standardmäßig enthält diese Eigenschaft eine leere Zeichenkette.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch setToolTip() und showStatusText().

text : QString

Diese Eigenschaft enthält den beschreibenden Text der Aktion

Wenn die Aktion zu einem Menü hinzugefügt wird, besteht der Menüpunkt aus dem Icon (falls vorhanden), dem Text und dem Shortcut (falls vorhanden). Wenn der Text nicht explizit im Konstruktor oder mit setText() gesetzt wird, wird der Text des Icons der Aktionsbeschreibung als Text verwendet. Es gibt keinen Standardtext.

Bestimmte UI-Elemente, wie Menüs oder Schaltflächen, können '&' vor einem Zeichen verwenden, um automatisch eine Eselsbrücke (ein Kürzel) für dieses Zeichen zu erstellen. Beispiel: "&Datei" für ein Menü erzeugt die Abkürzung Alt+F, die das Menü Datei öffnet. "E&xit" erzeugt die Abkürzung Alt+X für eine Taste oder ermöglicht in einem Menü die Navigation zu einem Menüpunkt durch Drücken von "x". (verwenden Sie '&&', um ein echtes kaufmännisches Und darzustellen). Das Widget kann eine Aktion auf eine bestimmte Verknüpfung anwenden und ausführen.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch iconText.

toolTip : QString

Diese Eigenschaft enthält den Tooltip der Aktion

Dieser Text wird für den Tooltip verwendet. Wenn kein Tooltip angegeben ist, wird der Text der Aktion verwendet.

Standardmäßig enthält diese Eigenschaft den Text der Aktion.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch setStatusTip() und setShortcut().

visible : bool

Diese Eigenschaft gibt an, ob die Aktion sichtbar ist (z. B. in Menüs und Symbolleisten).

Wenn visible true ist, ist die Aktion sichtbar (z. B. in Menüs und Symbolleisten) und kann vom Benutzer ausgewählt werden; wenn visible false ist, kann die Aktion vom Benutzer weder gesehen noch ausgewählt werden.

Aktionen, die nicht sichtbar sind, werden nicht ausgegraut, sondern gar nicht angezeigt.

Standardmäßig ist diese Eigenschaft true (Aktionen sind sichtbar).

Zugriffsfunktionen:

Benachrichtigungssignal:

whatsThis : QString

Diese Eigenschaft enthält den "Was ist das?"-Hilfetext der Aktion

Der "What's This?"-Text wird verwendet, um eine kurze Beschreibung der Aktion zu liefern. Der Text kann Rich-Text enthalten. Es gibt keinen Standardtext "What's This?".

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QWhatsThis.