动作 QML 类型

抽象用户界面动作。更多信息...

导入语句	import QtQuick.Controls
继承	QtObject

所有成员列表，包括继承成员

属性

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 {
    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.cache : bool
icon.color : color
icon.height : int
icon.name : string
icon.source : url
icon.width : int

名称	描述
name	此属性用于保留要使用的图标的名称。图标将从平台主题中加载。如果主题中找到图标，则它将始终使用；即使icon.source也已设置。如果未找到图标，将使用icon.source。有关主题图标的更多信息，请参阅QIcon::fromTheme。
source	此属性用于保留要使用的图标的名称。图标将以常规图像加载。如果icon.name已设置并引用有效主题图标，则它将始终使用，而不是此属性。
width	此属性用于保留图标的宽度。图标的宽度永远不会超过此值，尽管必要时会缩小。
height	此属性用于保留图标的长度。图标的长度永远不会超过此值，尽管必要时会缩小。
color	此属性用于保留图标的颜色。除非颜色设置为`"transparent"`，否则图标将使用指定颜色。
cache	此属性指定是否缓存图标。默认值为true。有关更多信息，请参阅cache。此属性是在QtQuick.Controls 2.13中引入的。

shortcut : keysequence

此属性持有操作的快捷键。按键组合可以设置为以下标准键盘快捷键之一：[链接到标准键盘快捷键页面]，或者可以描述为包含最多四次按键序列的字符串，这些按键序列是触发快捷键所需的。

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

text : 字符串

此属性持有操作的文本描述。

信号文档

toggled(QtObject source)

当操作被切换时，会发射此信号。参数 source 指定切换操作的对象。

例如，如果操作被分配到菜单项和工具栏按钮中，则在切换控件、激活快捷键或直接调用 toggle() 时，操作会被切换。

注意： 相应的处理函数是 onToggled。

triggered(QtObject source)

当操作被触发时，会发射此信号。参数 source 指定触发操作的对象。

例如，如果操作被分配到菜单项和工具栏按钮中，则在点击控件、激活快捷键或直接调用 trigger() 时，操作会被触发。

注意： 相应的处理函数是 onTriggered。

方法文档

void toggle(QtObject source)

切换操作，如果启用则发射 toggled() 信号，可以定义可选的 source 对象。

void trigger(QtObject source)

触发操作，如果启用则发射 triggered() 信号，可以定义可选的 source 对象。