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)

詳細な説明

Actionは、ショートカットを設定でき、メニュー項目やツールバーボタンに割り当て可能な、抽象的なユーザーインターフェース操作を表します。

アクションには、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 」も参照してください 。

プロパティのドキュメント

checkable : bool

このプロパティは、アクションがチェック可能かどうかを表します。デフォルト値はfalse です。

チェック可能なアクションは、トリガーされた際に、チェック状態（オン）とチェックなし状態（オフ）を切り替えます。

「checked」も参照してください 。

checked : bool

このプロパティは、アクションがチェックされているかどうかにかかわらず保持されます。

checkableも参照してください 。

enabled : bool

このプロパティは、アクションが有効かどうかを表します。デフォルト値はtrue です。

icon group

shortcut : keysequence

このプロパティには、アクションのショートカットが格納されます。キーシーケンスは、standard keyboard shortcuts のいずれかに設定できます（例：StandardKey.Copy ）。あるいは、ショートカットを実行するために必要な最大4つのキー入力のシーケンスを含む文字列で記述することもできます。

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

text : string

このプロパティには、アクションの説明文が格納されます。

Signal ドキュメント

toggled(QtObject source)

このシグナルは、アクションがトグルされたときに発火します。source 引数は、アクションをトグルしたオブジェクトを識別します。

たとえば、アクションがメニュー項目とツールバーボタンに割り当てられている場合、コントロールの切り替え、ショートカットの起動、または `toggle()` の直接呼び出しによって、アクションが切り替わります。

triggered(QtObject source)

このシグナルは、アクションがトリガーされたときに発生します。source 引数は、アクションをトリガーしたオブジェクトを識別します。

たとえば、アクションがメニュー項目とツールバーボタンに割り当てられている場合、コントロールがクリックされたとき、ショートカットが実行されたとき、または `trigger()` が直接呼び出されたときに、アクションがトリガーされます。

メソッドのドキュメント

void toggle(QtObject source)

アクションのオン/オフを切り替えます。有効になっている場合は、オプションで定義されたsource オブジェクトを使用してtoggled()を呼び出します。

void trigger(QtObject source)

アクションをトリガーし、有効になっている場合はtriggered()を発行します。この際、オプションでsource オブジェクトを定義することもできます。