Table of Contents

表格控件

表格控件的标签为Table,其实现类为XTableCtrl。表格控件是一个M列N行单元格的容器控件,每一个单元格包含一个控件,可以是编辑框,也可以是下拉框,也可以是勾选框。表格控件一般有一个列标题栏,显示每一列的标题,每一列可以指定它的宽度,列标题的设置在Header块中设定(参考【表格控件配置示例】)。表格控件的内容可以通过ref_url指定的参考配置文件进行配置。表格控件可以保存row_base, col_base的扩展属性用以设定其最小行数和列数,在定义了该扩展属性的情况下,用户动态修改表格控件的行数和列数时不得小于这些值。

表格控件提供了以下扩展槽,

控件属性关键字

name

控件名,其值类型为字符串,控件名只能以字母开头,可包含数字、下划线、点符号。参考示例:name=“test.tbl”。

enable

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

width

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

height

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

connect

动态事件信号的映射处理,表格控件支持的触发信号包括cellClicked(当单击表格项时触发),它会向命令发送Event_TableCellClicked事件信号,如果需要特别响应,可以在命令的onControlEvent接口里处理该信号。参考示例:connect=“cellClicked,:“。

ref_url

指向参考的配置xml文件路径,可参考下文下拉框选项配置文件示例章节。该路径为相对路径,其参考路径为项目资源目录下的uisetting文件夹,特别的,如果要参考全局资源目录下的文件,该路径应以”~“开头,”~“表示全局资源目录下的uisetting子目录。参考示例:ref_url=“material/types.xml”或”~/material/types.xml”。

title

当该控件为选项卡控件的子控件时,通过该属性定义它在选项卡控件中的选项卡的显示文本。

col_size

设置表格的列数,取值为大于0的整数。参考示例:col_size=“4”。

row_size

设置表格的行数,取值为整数,可以为0。参考示例:row_size=“4”。

表格头属性

表格头属性块的标签为Header(或者小写header),通过它的子项依次设定列的标题以及列宽。

text

设定列标题的显示文本。

width

设定列的宽度,其值类型整型, 单位为像素,如果没有设置该属性,XCGS将自动设定一个宽度值。参考示例:width=“30”。

表格控件配置示例

<Table name="feature.tbl" col_size="4" row_size="0">
	<header>
		<item text="部件" width="160"/>
		<item text="特征" width="100"/>
		<item text="对象" width="160"/>
		<item text="属性" />
	</header>
</Table>

相关API