User Tools

Site Tools


reference:widgets:xlabelctrl

标签

标签的XML标签为Label,标签一般用于向用户提示后面的控件的意义和用途,在不参与用户交互的场景中,配置标签的时候可以不设置标签名,这时XCGS会自动赋予一个唯一的名字给它。需要注意的是,在表单布局中,标签不会被显示声明,它会在创建表单控件时自动生成,并且它的名字和控件名存在对应关系。标签还支持背景图片的扩展,允许在标签中显示图片。

属性关键字

name

控件名,其值类型为字符串,控件名只能以字母开头,可包含数字、下划线、点符号,可以不设置,这时XCGS会自动赋予一个唯一的名字。参考示例:name=“value.label”。

text

用于设置标签的显示字符串,其值类型为字符串。参考示例:text=“hello”。

enable

设置控件的初始状态是否可交互,其值类型为布尔型(true或者false),如设置为false,在该控件会变灰并且不可交互,用户可调用ICommandWindow的setControlEnable接口修改该属性。参考示例:enable=“true”。

width

控件的宽度,其值类型整型, 单位为像素。参考示例:width=“30”。

height

控件的高度,其值类型整型, 单位为像素。参考示例:height=“30”。

connect

无。

image

指向标签的背景图片路径。该路径为相对路径,其参考路径为项目资源目录,特别的,如果要参考全局资源目录下的文件,该路径应以“~“开头,”~“表示全局资源目录。参考示例:image=“image/pattern-rectangle.png”或”~/image/pattern-rectangle.png”。

下拉框选项配置文件示例

     		<Label image="image/pattern-rectangle.png" width="256" height="256"/>

相关API

reference/widgets/xlabelctrl.txt · Last modified: 2024/04/26 11:57 (external edit)