Table of Contents
动作
动作控件的XML标签为Action，提供了一个抽象的用户界面操作，它可能包含图标、菜单文本、快捷方式、状态文本和工具提示， 动作可以作为独立对象创建，但也可以在构建菜单时创建。点击动作控件会触发triggered事件，开发者可以在命令的onControlEvent中编写响应代码。较常见的动态交互方式是将该控件关联另一个控件（通过value和ref_url属性），点击动作控件则在另外一个容器中（如堆栈控件）将关联控件按照ref_url构建并变为容器的当前控件。
控件属性关键字
name
控件名，其值类型为字符串，控件名只能以字母开头，可包含数字、下划线、点符号。参考示例：name=“value.act”。
cid
关联命令标识符，其值类型为字符串，仅在菜单栏、工具条或功能导航栏中使用，用于与标识符为给定值的命令关联绑定，点击按钮的操作将触发关联命令，如果当前文档不存在指定标识符的命令，则按钮不可用。特别的，当cid命名形式为“XXX.xml”时，将直接弹出被XXX.xml文件配置的测试对话框，用于快速构建演示界面使用。参考示例：cid=“CreateTable”。
enable
设置控件的初始状态是否可交互，其值类型为布尔型（true或者false），如设置为false，在该控件会变灰并且不可交互，用户可调用ICommandWindow的setControlEnable接口修改该属性。参考示例：enable=“true”。
checkable
设置控件是否可选中，其值类型为布尔型（true或者false），如设置为true，点击该控件可以将保持选中的状态，再次点击将取消选中状态。
width
控件的宽度，其值类型整型, 单位为像素。参考示例：width=“30”。
height
控件的高度，其值类型整型, 单位为像素。参考示例：height=“30”。
connect
动态事件信号的映射处理，按钮支持的触发信号包括triggered（当点击控件时触发）。参考示例：connect=“triggered,test.stack:setCurrentWidget”。
text
用于设置动作控件的显示文本，其值类型为字符串。参考示例：text=“hello”。
tip
用于设置动作控件的提示文本，其值类型为字符串。参考示例：tip=“打开文件”。
value
用于设置动作控件的值属性，其值类型为字符串，一般用于关联其他控件。参考示例：value=“test.sub”。
icon
指定动作控件的显示图标，该路径为相对路径，其参考路径为项目资源目录，特别的，如果要参考全局资源目录，该路径应以“~“开头，”~“表示全局资源目录。参考示例：ref_url=“material/types.png”或”~/material/types.png”。
auto_raise
设置是否在鼠标指向按钮时自动凸起，默认为自动凸起。参考示例：auto_raise=“true”。
style
动作控件的风格，取值为整型，限定为0、1、2、3，其中0表示只显示图标；1表示只显示文本；2表示显示图标和文本，文本在图标旁边； 3表示显示图标和文本，文本在图标下面。参考示例：style=“1”。
ref_url
指定动作控件的参考链接属性，一般用于关联其他容器的子控件配置文件路径，该路径为相对路径，其参考路径为项目资源目录，特别的，如果要参考全局资源目录，该路径应以“~“开头，”~“表示全局资源目录。参考示例：ref_url=“material/types.xml”或”~/material/types.xml”。
配置示例
<Action name="mac_file.check" text="选择" value="5" />
相关API
