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()
}

Action 通常用于实现可通过菜单项、工具栏按钮或键盘快捷键调用的应用程序命令。由于用户希望无论使用何种用户界面，都能以相同的方式执行命令，因此将命令表示为可共享的动作非常有用。

动作还可用于分离逻辑和视觉表现。例如，在.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 。

属性文档

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

信号文档

方法文档