Action QML Type

抽象的なユーザー・インターフェース・アクション。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• 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

シグナル

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

メソッド

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

詳細説明

アクションは、ショートカットを持つことができ、メニュー項目やツールバーボタンに割り当てることができる抽象的なユーザーインターフェイスアクションを表します。

アクションには、text 、icon 、shortcut を含めることができます。アクションは通常、メニュー項目、ツールバーボタン、またはキーボードショートカットを介してユーザーによってtriggered 。checkable アクションは、トリガーされるとchecked の状態を切り替えます。

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

アクションは一般的に、メニュー項目、ツールバーボタン、キーボードショートカットを介して呼び出すことができるアプリケーションコマンドを実装するために使用されます。ユーザーは、使用されるユーザーインターフェイスに関係なく、コマンドが同じ方法で実行されることを期待するので、共有可能なアクションとしてコマンドを表現することは便利です。

アクションは、ロジックと視覚的な表示を分離するためにも使用できます。例えば、.ui.qml ファイルでボタンやメニュー項目を宣言する場合、アクションは別の場所で宣言し、外部から割り当てることができます。

ToolButton {
    id: toolButton
    action: copyAction
}

アクションがボタンやメニュー項目とペアになると、enabled 、checkable 、checked の状態が自動的に同期されます。例えばワープロでは、ユーザーが「太字」ツールバーボタンをクリックすると、「太字」メニュー項目が自動的にチェックされます。ボタンとメニュー項目は、デフォルトでアクションからtext とicon を取得します。アクション固有のtext またはicon は、コントロール上で直接text またはicon を指定することで、特定のコントロールに対してオーバーライドすることができます。

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

Actionはユーザーインターフェースのアクションを示すので、MenuItem 、ToolButton 、またはAbstractButton を継承する他のコントロールに割り当てることを意図しています。キーボードショートカットの場合は、より単純なShortcut タイプの方が適切です。

MenuItem 、ToolButton 、Shortcutも参照してください 。

プロパティ Documentation

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

シグナルの説明

メソッド・ドキュメント