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も参照してください 。

プロパティ文書

checkable : bool

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

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

checkedも参照してください 。

checked : bool

このプロパティは、アクションがチェックされるかどうかを保持する。

checkableも参照してください 。

enabled : bool

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

icon group

shortcut : keysequence

このプロパティはアクションのショートカットを保持する。キー・シーケンスは、standard keyboard shortcuts のいずれかに設定するか、ショートカットをトリガするために必要な最大4つのキー押下のシーケンスを含む文字列で記述することができます。

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

text : string

このプロパティは、アクションのテキスト記述を保持する。

シグナルのドキュメント

toggled(QtObject source)

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

たとえば、アクションがメニュー項目とツールバーボタンに割り当てられている場合、コントロールがトグルされるか、ショートカットがアクティブになるか、toggle() が直接呼び出されると、アクションがトグルされます。

triggered(QtObject source)

このシグナルは、アクションがトリガーされたときに発せられる。引数source は、アクションをトリガーしたオブジェクトを特定する。

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

メソッド・ドキュメント

void toggle(QtObject source)

アクションをトグルし、有効であればtoggled() を発する。オプションでsource オブジェクトが定義されている。

void trigger(QtObject source)

アクションをトリガーし、有効であればtriggered() を出力します。オプションでsource オブジェクトが定義されています。