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 zugewiesen werden, das AbstractButton erbt. Für Tastaturkürzel ist der einfachere Typ Shortcut besser geeignet.

Siehe auch MenuItem, ToolButton, und Shortcut.

Eigenschaft Dokumentation

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

Signal Dokumentation

Methode Dokumentation