Action QML Type

Abstrakte Aktion der Benutzeroberfläche. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• checkable : bool
• checked : bool
• enabled : bool
• icon
  • icon.cache : bool
  • icon.color : color
  • icon.height : int
  • icon.name : string
  • icon.source : url
  • icon.width : int
• shortcut : keysequence
• text : string

Signale

• toggled(QtObject source)
• triggered(QtObject source)

Methoden

• void toggle(QtObject source)
• void trigger(QtObject source)

Detaillierte Beschreibung

Action stellt eine abstrakte Aktion der Benutzeroberfläche dar, die Tastenkombinationen haben kann und Menüpunkten und Symbolleistenschaltflächen zugewiesen werden kann.

Aktionen können text, icon und shortcut enthalten. Aktionen werden normalerweise triggered vom Benutzer über Menüeinträge, Symbolleistenschaltflächen oder Tastenkombinationen aufgerufen. Eine checkable Aktion schaltet ihren checked Zustand um, wenn sie ausgelöst wird.

Action {
    id: copyAction
    text: qsTr("&Copy")
    icon.name: "edit-copy"
    shortcut: StandardKey.Copy
    onTriggered: window.activeFocusItem.copy()
}

Aktionen werden üblicherweise verwendet, um Anwendungsbefehle zu implementieren, die über Menüpunkte, Symbolleistenschaltflächen und Tastenkombinationen aufgerufen werden können. Da der Benutzer erwartet, dass die Befehle auf die gleiche Weise ausgeführt werden, unabhängig von der verwendeten Benutzeroberfläche, ist es sinnvoll, die Befehle als gemeinsam nutzbare Aktionen darzustellen.

Aktionen können auch verwendet werden, um die Logik und die visuelle Darstellung zu trennen. Zum Beispiel können bei der Deklaration von Schaltflächen und Menüpunkten in .ui.qml Dateien Aktionen an anderer Stelle deklariert und von außen zugewiesen werden.

ToolButton {
    id: toolButton
    action: copyAction
}

Wenn eine Aktion mit Schaltflächen und Menüpunkten verknüpft wird, werden die Zustände enabled, checkable und checked automatisch synchronisiert. Wenn der Benutzer beispielsweise in einem Textverarbeitungsprogramm auf eine Schaltfläche "Fett" in der Symbolleiste klickt, wird der Menüeintrag "Fett" automatisch aktiviert. Schaltflächen und Menüelemente erhalten ihre text und icon standardmäßig von der Aktion. Eine aktionsspezifische text oder icon kann für ein bestimmtes Steuerelement durch Angabe von text oder icon direkt auf dem Steuerelement außer Kraft gesetzt werden.

MenuItem {
    id: menuItem
    action: copyAction
    text: qsTr("&Copy selected Text")
}

Da Action eine Aktion für die Benutzeroberfläche darstellt, soll sie einem MenuItem, ToolButton oder einem anderen Steuerelement, das AbstractButton erbt, zugewiesen werden. Für Tastaturkürzel ist der einfachere Typ Shortcut besser geeignet.

Siehe auch MenuItem, ToolButton, und Shortcut.

Dokumentation der Eigenschaft

checkable : bool

Diese Eigenschaft gibt an, ob die Aktion überprüfbar ist. Der Standardwert ist false.

Eine überprüfbare Aktion schaltet bei ihrer Auslösung zwischen aktiviert (on) und nicht aktiviert (off) um.

Siehe auch checked.

checked : bool

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

Siehe auch checkable.

enabled : bool

Diese Eigenschaft gibt an, ob die Aktion aktiviert ist. Der Standardwert ist true.

icon group

shortcut : keysequence

Diese Eigenschaft enthält das Tastenkürzel der Aktion. Die Tastenfolge kann auf eine der standard keyboard shortcuts festgelegt werden, oder sie kann mit einer Zeichenkette beschrieben werden, die eine Folge von bis zu vier Tastendrücken enthält, die zum Auslösen der Tastenkombination erforderlich sind.

Action {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

text : string

Diese Eigenschaft enthält eine textliche Beschreibung der Aktion.

Signal-Dokumentation

toggled(QtObject source)

Dieses Signal wird ausgesendet, wenn die Aktion umgeschaltet wird. Das Argument source identifiziert das Objekt, das die Aktion umgeschaltet hat.

Wenn die Aktion z. B. einem Menüpunkt und einer Symbolleistenschaltfläche zugewiesen ist, wird die Aktion umgeschaltet, wenn das Steuerelement umgeschaltet wird, die Verknüpfung aktiviert wird oder wenn toggle() direkt aufgerufen wird.

triggered(QtObject source)

Dieses Signal wird ausgesendet, wenn die Aktion ausgelöst wird. Das Argument source identifiziert das Objekt, das die Aktion ausgelöst hat.

Wenn die Aktion beispielsweise einem Menüpunkt und einer Symbolleistenschaltfläche zugewiesen ist, wird die Aktion ausgelöst, wenn das Steuerelement angeklickt wird, die Verknüpfung aktiviert wird oder wenn trigger() direkt aufgerufen wird.

Dokumentation der Methode

void toggle(QtObject source)

Schaltet die Aktion um und sendet toggled(), wenn aktiviert, mit einem optionalen source Objekt definiert.

void trigger(QtObject source)

Löst die Aktion aus und sendet triggered(), wenn aktiviert, mit einem optionalen source Objekt definiert.