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.
====== 表格控件 ======

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

表格控件提供了以下扩展槽，
  * void onCellClicked()，用于勾选所有表格项；
  * void moveRowUp()，用于清除所有勾选项；
  * void moveRowDown()，用于方向勾选表格项；

===== 控件属性关键字 =====

==== 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"。	

===== 表格控件配置示例 =====
<code>
<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>
</code>

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

  * [[class:ui:icommandwindow#settablefromstring|setTableFromString]]
  * [[class:ui:icommandwindow#settablefromclipboard|setTableFromClipboard]]
  * [[class:ui:icommandwindow#gettabletoclipboard|getTableToClipboard]]
  * [[class:ui:icommandwindow#settablerowcount|setTableRowCount]]
  * [[class:ui:icommandwindow#gettablerowcount|getTableRowCount]]
  * [[class:ui:icommandwindow#settablecolcount|setTableColCount]]
  * [[class:ui:icommandwindow#gettablecolcount|getTableColCount]]
  * [[class:ui:icommandwindow#addtablecombooption|addTableComboOption]]
  * [[class:ui:icommandwindow#settablechecked|setTableChecked]]
  * [[class:ui:icommandwindow#settablecomboint|setTableComboInt]]
  * [[class:ui:icommandwindow#settablecombostring|setTableComboString]]
  * [[class:ui:icommandwindow#settableeditablecombo|setTableEditableCombo]]
  * [[class:ui:icommandwindow#settablecombooptions|setTableComboOptions]]
  * [[class:ui:icommandwindow#settableeditint|setTableEditInt]]
  * [[class:ui:icommandwindow#settableeditstring|setTableEditString]]
  * [[class:ui:icommandwindow#settableeditpath|setTableEditPath]]
  * [[class:ui:icommandwindow#settableeditdouble|setTableEditDouble]]
  * [[class:ui:icommandwindow#settablelabelstring|setTableLabelString]]
  * [[class:ui:icommandwindow#gettableeditdouble|getTableEditDouble]]
  * [[class:ui:icommandwindow#gettablecomboint|getTableComboInt]]
  * [[class:ui:icommandwindow#gettablecombotext|getTableComboText]]
  * [[class:ui:icommandwindow#gettablecombostring|getTableComboString]]
  * [[class:ui:icommandwindow#gettablechecked|getTableChecked]]
  * [[class:ui:icommandwindow#gettableeditint|getTableEditInt]]
  * [[class:ui:icommandwindow#gettableeditstring|getTableEditString]]
  * [[class:ui:icommandwindow#gettablecurrentrow|getTableCurrentRow]]
  * [[class:ui:icommandwindow#gettablecurrentcol|getTableCurrentCol]]
  * [[class:ui:icommandwindow#adjusttableview|adjustTableView]]
  * [[class:ui:icommandwindow#removetablerow|removeTableRow]]
  * [[class:ui:icommandwindow#inserttablerow|insertTableRow]]
  * [[class:ui:icommandwindow#gettableselectionrange|getTableSelectionRange]]
  * [[class:ui:icommandwindow#clearcontent|clearContent]]
  * [[class:ui:icommandwindow#setcurrentsub|setCurrentSub]]
  * [[class:ui:icommandwindow#reloadsub|reloadSub]]
XT Document

User Tools

Site Tools

Page Tools
