Action QML Type

Abstrakte Benutzeroberflächenaktion. 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)

Ausführliche Beschreibung

„Action“ steht für eine abstrakte Benutzeroberflächenaktion, die Tastenkombinationen haben und Menüeinträgen sowie Symbolleisten-Schaltflächen zugewiesen werden kann.

Aktionen können eine „ text “, eine „ icon “ und eine „ shortcut “ enthalten. Aktionen werden in der Regel vom Benutzer über Menüelemente, Symbolleisten-Schaltflächen oder Tastaturkürzel „ triggered “. Eine „ checkable “-Aktion schaltet bei ihrer Auslösung ihren „ checked “-Zustand um.

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

Aktionen werden häufig verwendet, um Anwendungsbefehle zu implementieren, die über Menüeinträge, Symbolleisten-Schaltflächen und Tastaturkürzel aufgerufen werden können. Da der Benutzer erwartet, dass die Befehle unabhängig von der verwendeten Benutzeroberfläche auf dieselbe Weise ausgeführt werden, ist es sinnvoll, die Befehle als gemeinsam nutzbare Aktionen darzustellen.

Aktionen können auch dazu verwendet werden, die Logik von der visuellen Darstellung zu trennen. Wenn beispielsweise Schaltflächen und Menüeinträge in „ .ui.qml “-Dateien deklariert werden, können Aktionen an anderer Stelle deklariert und von außen zugewiesen werden.

ToolButton {
    id: toolButton
    action: copyAction
}

Wenn eine Aktion mit Schaltflächen und Menüeinträgen verknüpft ist, werden die Zustände „ enabled “, „ checkable “ und „ checked “ automatisch synchronisiert. Wenn der Benutzer beispielsweise in einem Textverarbeitungsprogramm auf die Schaltfläche „Fett“ in der Symbolleiste klickt, wird der Menüpunkt „Fett“ automatisch aktiviert. Schaltflächen und Menüeinträge beziehen standardmäßig ihre Werte für „ text “ und „ icon “ aus der Aktion. Ein aktionsspezifischer Wert für „ text “ oder „ icon “ kann für ein bestimmtes Steuerelement überschrieben werden, indem „ text “ oder „ icon “ direkt am Steuerelement angegeben werden.

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

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

Siehe auch „ MenuItem “, „ ToolButton “ und „ Shortcut “.

Dokumentation zur Eigenschaft

checkable : bool

Diese Eigenschaft gibt an, ob die Aktion aktivierbar ist. Der Standardwert lautet „ false “.

Eine aktivierbare Aktion wechselt bei ihrer Auslösung zwischen „aktiviert“ (eingeschaltet) und „deaktiviert“ (ausgeschaltet).

Siehe auch „ checked “.

checked : bool

Diese Eigenschaft gilt unabhängig davon, ob das Kontrollkästchen aktiviert ist.

Siehe auch checkable.

enabled : bool

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

icon group

shortcut : keysequence

Diese Eigenschaft enthält die Tastenkombination für die Aktion. Die Tastenkombination kann auf eine der folgenden Tasten festgelegt werden: „ standard keyboard shortcuts “ (zum Beispiel „ StandardKey.Copy “), oder sie kann durch eine Zeichenfolge beschrieben werden, die eine Abfolge von bis zu vier Tastenanschlägen 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 textuelle Beschreibung der Aktion.

Signal-Dokumentation

toggled(QtObject source)

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

Wenn die Aktion beispielsweise einem Menüpunkt und einer Symbolleisten-Schaltfläche zugewiesen ist, wird die Aktion umgeschaltet, wenn das Steuerelement umgeschaltet, die Tastenkombination aktiviert oder die Funktion ` 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 Symbolleisten-Schaltfläche zugewiesen ist, wird sie ausgelöst, wenn auf das Steuerelement geklickt wird, die Tastenkombination aktiviert wird oder wenn trigger() direkt aufgerufen wird.

Methodendokumentation

void toggle(QtObject source)

Schaltet die Aktion ein oder aus und löst bei Aktivierung ein „ toggled()“ aus, wobei optional ein „ source “-Objekt definiert ist.

void trigger(QtObject source)

Löst die Aktion aus und gibt, sofern aktiviert, „ triggered()“ aus, wobei ein optionales „ source “-Objekt definiert ist.