QML类型说明-Action

Action

ImportStatement:   importQtQuick.Controls 1.2

 

Properties

checkable : bool

checked : bool

enabled : bool

exclusiveGroup : ExclusiveGroup

iconName : string

iconSource : url

shortcut : keysequence

text : string

tooltip : string

 

Signals

toggled(checked)

triggered(QObject * source)

 

Methods

trigger(QObject * source)

 

DetailedDescription

在应用程序的菜单、工具条和快捷键中，有许多常见的相同的命令。用户期待不管使用什么样的用户界面，每个命令都能使用相同的操作让其执行。因此，将每个命令表示为一个动作，就是非常有益的。一个动作绑定到应用程序的相应菜单和工具按钮，它就能同步的执行。例如，在文档处理中，如果用户按下粗体的工具按钮，粗体动作自动被校验到。

QtQuick控件支持在工具按钮和菜单上操作动作。

例如：

Action {

id: openAction

text: "&Open"

shortcut: "Ctrl+O"

iconSource: "images/document-open.png"

onTriggered: fileDialog.open()

tooltip: "Open an Image"

}

PropertyDocumentation

checkable : bool

菜单是否可校验，默认为假。同时查阅checked和exclusiveGroup.

 

checked : bool

如果动作是可校验得，这个属性反应了校验的状态。默认为假。当checkable为假时，这个属性也是假。同时参阅toggled和exclusiveGroup。

 

enabled : bool

动作是否启动，是否能被触发。默认为真。同时参阅trigger() 和triggered。

 

exclusiveGroup : ExclusiveGroup

如果一个动作是可校验的，则可以关联到一个ExclusiveGroup。所有的动作共享同样的执行组。从中选择各自的执行。这意味着只有最后的动作能被响应。这个属性默认为空，意味着没有预期的执行行为。同时参阅checkableand checked。

 

iconName : string

设置动作的图标名。元件从当前主题获取图标。默认是空字符。

 

iconSource : url

为动作设置图标文件或资源url。默认为空URL。

 

shortcut : keysequence

绑定动作到快捷键。keysequence可以是一组字符或独立的标准快捷键。默认为空字符。

Action {

id: copyAction

text: qsTr("&Copy")

shortcut: StandardKey.Copy

}

 

text : string

动作的文本。文本将会显示在按钮或菜单上。通过前缀&转义到快捷键能被支持。例如"\&Open"将绑定Alt-O快捷键到"Open"菜单元件。注意不是所有的平台都支持前缀转义。默认空字符。

 

tooltip : string

当悬停在动作上时，tooltip将会显示。不是所有平台的所有控件都支持tooltips，尤其是MenuItem。默认为空字符。

 

SignalDocumentation

toggled(checked)

当动作检测到checked属性变化时发射。这通常发生在触发的同时。相应的处理程序为onToggled。

 

triggered(QObject * source)

当菜单或绑定的动作被激活时发射。包含向关联的触发事件。如（按钮或菜单）我们不应该发射这个信号，使用trigger()替代。关联的处理程序是onTriggered。

 

MethodDocumentation

trigger(QObject * source)

如果动作被启用，则发出触发信号。我们可以提供源对象，从明确的触发源分析触发响应的动作。如果checkable为真，也发射toggled信号。