Table of Contents

列表控件

列表控件的标签为List，其实现类为XListCtrl。列表控件包含若干列表项，列表项可绑定特征值（不同列表项的特征值不可重复，否则冲突），且列表项可设置前置勾选框使用户可以勾选某个列表项。列表控件可以直接设置各种关键字，也可以通过ref_url指定控件的参考配置文件对列表控件进行配置。

列表控件提供了以下扩展槽，

控件属性关键字

name

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

enable

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

width

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

height

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

connect

动态事件信号的映射处理，列表控件支持的触发信号包括itemDoubleClicked（当双击列表项时触发）、currentItemChanged（当选择不同的列表项时）、currentRowChanged（当选择不同的列表项时）。参考示例：connect=“itemDoubleClicked,test.stack:setCurrentWidget”。

ref_url

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

title

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

列表项属性

value

设定列表项的值，通过该属性定义它在tab控件中的tab页的显示文本。

text

设定列表项的显示文本，通过该属性定义它在tab控件中的tab页的显示文本。

将列表项与目标控件关联，通过该属性定义它在tab控件中的tab页的显示文本。参考示例：link=“test.stack”。

check

设置列表项是否可勾选，取值为布尔类型（true或则false）。默认为false，列表不出现勾选框

列表控件配置参考示例

<List name="entry_list" connect="itemDoubleClicked,detail_stack:setCurrentWidget">
	<Item text="功能1" value="1" link="test1.stack" check="true" />
	<Item text="功能2" value="2" link="test2.stack" check="true" />
	<ContextMenu>
		<action icon="::42" text="脚本载入" name="menu_Load.act"/>
		<action icon="::43" text="脚本另存" name="menu_Save.act"/>
		<action icon="::66" text="运行全部" name="menu_RunAll.act"/>
		<action icon="::64" text="运行选中" name="menu_RunSelect.act"/>
	</ContextMenu>
</List>

相关API