====== 按钮 ====== 按钮的XML标签为Button,点击它会触发Event_Clicked事件,开发者在命令的onControlEvent接口中处理该事件,在需要单击鼠标弹出对话框的场合,XCGS为按钮提供了ref_url的扩展以指定弹出对话框的配置文件路径以简化开发过程。 ===== 控件属性关键字 ===== ==== name ==== 控件名,其值类型为字符串,控件名只能以字母开头,可包含数字、下划线、点符号。参考示例:name="value.btn"。 ==== enable ==== 设置控件的初始状态是否可交互,其值类型为布尔型(true或者false),如设置为false,在该控件会变灰并且不可交互,用户可调用ICommandWindow的setControlEnable接口修改该属性。参考示例:enable="true"。 ==== width ==== 控件的宽度,其值类型整型, 单位为像素。参考示例:width="30"。 ==== height ==== 控件的高度,其值类型整型, 单位为像素。参考示例:height="30"。 ==== label ==== 仅当在表单布局中添加按钮时使用,用于指定该控件所对应的标签的显示文本。参考示例:label="显示文本"。 ==== connect ==== 动态事件信号的映射处理,按钮支持的触发信号包括clicked(当点击按钮时触发)。参考示例:connect="clicked,:popDialog"。 ==== text ==== 用于设置按钮选项的显示字符串,其值类型为字符串。参考示例:text="hello"。 ==== icon ==== 按钮的图标路径。该路径为相对路径,其参考路径为项目资源目录,特别的,如果要参考全局资源目录下的文件,该路径应以"~"开头,"~"表示全局资源目录。参考示例:ref_url="icon/export.png"或"~/icon/export.png"。 ==== ref_url ==== 指向弹出对话框的配置xml文件路径。该路径为相对路径,其参考路径为项目资源目录下的uisetting文件夹,特别的,如果要参考全局资源目录下的文件,该路径应以"~"开头,"~"表示全局资源目录下的uisetting子目录。参考示例:ref_url="material/types.xml"或"~/material/types.xml"。 ===== 按钮选项配置文件示例 =====