标签的XML标签为Label,标签一般用于向用户提示后面的控件的意义和用途,在不参与用户交互的场景中,配置标签的时候可以不设置标签名,这时XCGS会自动赋予一个唯一的名字给它。需要注意的是,在表单布局中,标签不会被显示声明,它会在创建表单控件时自动生成,并且它的名字和控件名存在对应关系。标签还支持背景图片的扩展,允许在标签中显示图片。
控件名,其值类型为字符串,控件名只能以字母开头,可包含数字、下划线、点符号,可以不设置,这时XCGS会自动赋予一个唯一的名字。参考示例:name=“value.label”。
用于设置标签的显示字符串,其值类型为字符串。参考示例:text=“hello”。
设置控件的初始状态是否可交互,其值类型为布尔型(true或者false),如设置为false,在该控件会变灰并且不可交互,用户可调用ICommandWindow的setControlEnable接口修改该属性。参考示例:enable=“true”。
控件的宽度,其值类型整型, 单位为像素。参考示例:width=“30”。
控件的高度,其值类型整型, 单位为像素。参考示例:height=“30”。
无。
指向标签的背景图片路径。该路径为相对路径,其参考路径为项目资源目录,特别的,如果要参考全局资源目录下的文件,该路径应以“~“开头,”~“表示全局资源目录。参考示例:image=“image/pattern-rectangle.png”或”~/image/pattern-rectangle.png”。
<Label image="image/pattern-rectangle.png" width="256" height="256"/>