QAction Class

Eigenschaftsdokumentation

autoRepeat : bool

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

Wenn „true“, wird die Aktion automatisch wiederholt, solange die Tastenkombination gedrückt gehalten wird, vorausgesetzt, die automatische Tastenwiederholung ist im System aktiviert. Der Standardwert ist „true“.

Zugriffsfunktionen:

Benachrichtigungssignal:

checkable : bool

Diese Eigenschaft gilt unabhängig davon, ob es sich bei der Aktion um eine schaltbare Aktion handelt

Eine umschaltbare Aktion ist eine Aktion, die einen Ein-/Aus-Zustand hat. In einem Textverarbeitungsprogramm kann beispielsweise die Schaltfläche „Fett“ in der Symbolleiste entweder aktiviert oder deaktiviert sein. Eine Aktion, die keine umschaltbare Aktion ist, ist eine Befehlsaktion; eine Befehlsaktion wird einfach ausgeführt, z. B. „Datei speichern“. Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt.

In manchen Situationen sollte der Zustand einer Umschaltaktion vom Zustand anderer Aktionen abhängen. Beispielsweise schließen sich die Umschaltaktionen „Linksbündig“, „Zentriert“ und „Rechtsbündig“ gegenseitig aus. Um ein exklusives Umschalten zu erreichen, fügen Sie die entsprechenden Umschaltaktionen einer „ QActionGroup “ hinzu, wobei die Eigenschaft „QActionGroup::exclusive“ auf „true“ gesetzt ist.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ setChecked()“.

checked : bool

Diese Eigenschaft gibt an, ob die Aktion markiert ist.

Nur markierbare Aktionen können markiert werden. Standardmäßig ist diese Eigenschaft auf „false“ gesetzt (die Aktion ist nicht markiert).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ checkable “ und „ toggled “ ().

enabled : bool

Diese Eigenschaft gilt unabhängig davon, ob die Aktion aktiviert ist

Deaktivierte Aktionen können vom Benutzer nicht ausgewählt werden. Sie verschwinden zwar nicht aus Menüs oder Symbolleisten, werden jedoch so dargestellt, dass deutlich wird, dass sie nicht verfügbar sind. Beispielsweise können sie ausschließlich in Graustufen angezeigt werden.

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

Eine Aktion wird deaktiviert, wenn alle Widgets, denen sie hinzugefügt wurde (mit ` QWidget::addAction()`), deaktiviert oder nicht sichtbar sind. Ist eine Aktion deaktiviert, kann sie nicht über ihre Tastenkombination ausgelöst werden.

Standardmäßig ist diese Eigenschaft auf „ true “ gesetzt (Aktionen sind aktiviert).

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch ` text`.

font : QFont

Diese Eigenschaft enthält die Schriftart der Aktion

Die Eigenschaft „font“ dient zur Darstellung des in „ QAction “ festgelegten Textes. Die Schriftart kann als Hinweis betrachtet werden, da sie je nach Anwendung und Stil nicht in allen Fällen berücksichtigt wird.

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

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch ` setText()`

icon : QIcon

Diese Eigenschaft enthält das Symbol der Aktion

In Symbolleisten wird das Symbol als Symbol für die Schaltfläche verwendet; in Menüs wird es links neben dem Menütext angezeigt, sofern „ QAction::iconVisibleInMenu “ den Wert „ true “ zurückgibt.

Es gibt kein Standard-Symbol.

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

Zugriffsfunktionen:

Notifier-Signal:

iconText : QString

Diese Eigenschaft enthält den beschreibenden Text des Aktionssymbols

Wenn „ QToolBar::toolButtonStyle “ auf einen Wert gesetzt ist, der die Anzeige von Text zulässt, erscheint der in dieser Eigenschaft definierte Text als Beschriftung auf der entsprechenden Schaltfläche.

Er dient außerdem als Standardtext in Menüs und Tooltips, wenn die Aktion nicht mit „ setText()“ oder „ setToolTip()“ definiert wurde, und wird auch in Symbolleisten-Schaltflächen verwendet, wenn kein Symbol mit „ setIcon()“ definiert wurde.

Wird der Symboltext nicht explizit festgelegt, wird der normale Text der Aktion als Symboltext verwendet.

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

Zugriffsfunktionen:

Notifier-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, dass Aktionen in der Symbolleiste mit Symbolen angezeigt werden, in Menüs jedoch nicht. Ist der Wert „true“, wird das Symbol (sofern vorhanden) im Menü angezeigt; ist der Wert „false“, wird es nicht angezeigt.

Standardmäßig richtet sich die Anzeige danach, ob für die Anwendung das Attribut „ Qt::AA_DontShowIconsInMenus “ gesetzt ist. Durch die explizite Festlegung dieser Eigenschaft wird das Vorhandensein (oder Fehlen) des Attributs außer Kraft gesetzt.

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:

Notifier-Signal:

Siehe auch „ icon “ und „ QCoreApplication::setAttribute()“.

menuRole : MenuRole

Diese Eigenschaft gibt die Menürolle der Aktion an

Dies gibt an, welche Rolle die Aktion im Anwendungsmenü unter macOS einnimmt. Standardmäßig haben alle Aktionen die Rolle „ TextHeuristicRole “, was bedeutet, dass die Aktion anhand ihres Textes hinzugefügt wird (weitere Informationen finden Sie unter QMenuBar ).

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

Zugriffsfunktionen:

Notifier-Signal:

priority : Priority

Diese Eigenschaft gibt die Priorität der Aktion in der Benutzeroberfläche an.

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

Wenn beispielsweise für Symbolleisten der Modus „ Qt::ToolButtonTextBesideIcon “ eingestellt ist, werden bei Aktionen mit der Eigenschaft „ LowPriority “ keine Textbeschriftungen angezeigt.

Zugriffsfunktionen:

Benachrichtigungssignal:

shortcut : QKeySequence

Diese Eigenschaft enthält die primäre Tastenkombination der Aktion

Gültige Tastencodes für diese Eigenschaft finden Sie unter Qt::Key und Qt::Modifier. Es gibt keine Standard-Tastenkombination.

Zugriffsfunktionen:

Benachrichtigungssignal:

shortcutContext : Qt::ShortcutContext

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

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

Zugriffsfunktionen:

Notifier-Signal:

shortcutVisibleInContextMenu : bool

Diese Eigenschaft legt fest, ob für eine Aktion ein Tastenkürzel im Kontextmenü angezeigt werden soll oder nicht

In manchen Anwendungen kann es sinnvoll sein, Aktionen mit Tastenkombinationen in Kontextmenüs anzuzeigen. Ist der Wert „true“, wird die Tastenkombination (sofern gültig) angezeigt, wenn die Aktion über ein Kontextmenü aufgerufen wird; ist der Wert „false“, wird sie nicht angezeigt.

Standardmäßig richtet sich die Anzeige danach, ob für die Anwendung das Attribut „ Qt::AA_DontShowShortcutsInContextMenus “ gesetzt ist. Durch explizites Setzen dieser Eigenschaft wird das Attribut überschrieben.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ shortcut “ und „ QCoreApplication::setAttribute()“.

statusTip : QString

Diese Eigenschaft enthält den Status-Hinweis der Aktion

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

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

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ setToolTip()“ und „ showStatusText()“.

text : QString

Diese Eigenschaft enthält den beschreibenden Text der Aktion

Wird die Aktion zu einem Menü hinzugefügt, besteht die Menüoption aus dem Symbol (sofern vorhanden), dem Text und der Tastenkombination (sofern vorhanden). Wird der Text nicht explizit im Konstruktor oder mithilfe von `setText()` festgelegt, wird der Beschreibungstext des Symbols der Aktion als Text verwendet. Es gibt keinen Standardtext.

Bestimmte UI-Elemente, wie Menüs oder Schaltflächen, können ein „&“ vor einem Zeichen verwenden, um automatisch eine Mnemonik (eine Tastenkombination) für dieses Zeichen zu erstellen. Beispielsweise erzeugt „&File“ für ein Menü die Tastenkombination „ Alt+F “, die das Menü „Datei“ öffnet. „E&xit“ erzeugt für eine Schaltfläche die Tastenkombination Alt+X oder ermöglicht in einem Menü das Aufrufen des Menüelements durch Drücken von „x“. (Verwenden Sie „&&“, um ein echtes Und-Zeichen anzuzeigen.) Das Widget kann eine bestimmte Tastenkombination verarbeiten und eine Aktion ausführen.

Zugriffsfunktionen:

Notifier-Signal:

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:

Notifier-Signal:

Siehe auch setStatusTip() und setShortcut().

visible : bool

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

Ist „visible“ auf „true“ gesetzt, ist die Aktion sichtbar (z. B. in Menüs und Symbolleisten) und kann vom Benutzer ausgewählt werden; ist „visible“ auf „false“ gesetzt, ist die Aktion für den Benutzer weder sichtbar noch auswählbar.

Aktionen, die nicht sichtbar sind, werden nicht ausgegraut; sie werden überhaupt nicht angezeigt.

Standardmäßig ist diese Eigenschaft auf „ true “ gesetzt (Aktionen sind sichtbar).

Zugriffsfunktionen:

Notifier-Signal:

whatsThis : QString

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

Der „Was ist das?“-Text dient dazu, eine kurze Beschreibung der Aktion zu liefern. Der Text kann Rich-Text enthalten. Es gibt keinen Standardtext für „Was ist das?“.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QWhatsThis “.