XT Document

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 标签 ======

标签的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"。


===== 下拉框选项配置文件示例 ===== 
<code>
     		<Label image="image/pattern-rectangle.png" width="256" height="256"/>
</code>

===== 相关API =====

  * [[class:ui:icommandwindow#setcontrolenable|setControlEnable]]
  * [[class:ui:icommandwindow#setcontrolvisible|setControlVisible]]
XT Document

User Tools

Site Tools

Page Tools
