User Tools

Site Tools


reference:widgets:xbuttonctrl

按钮

按钮的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”。

按钮选项配置文件示例

	<Button name="mac_file.btn" text="浏览"/>

相关API

reference/widgets/xbuttonctrl.txt · Last modified: 2024/02/28 14:24 (external edit)