====== 列表控件 ======

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

列表控件提供了以下扩展槽，
  * void checkAll()，用于勾选所有列表项；
  * void uncheckAll()，用于清除所有勾选项；
  * void checkInverse()，用于方向勾选列表项；
  * void onCheckItem(QListWidgetItem * item)，用于响应可勾选列表项的勾选事件，它会根据列表项的勾选状态向命令发出Event_Checked或者Event_Unchecked事件信号，开发者需要在命令的onControlEvent中予以处理。

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

==== 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页的显示文本。	

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

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

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

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

  * [[class:ui:icommandwindow#setcontrolenable|setControlEnable]]
  * [[class:ui:icommandwindow#setcontrolvisible|setControlVisible]]
  * [[class:ui:icommandwindow#addlistitem|addListItem]]
  * [[class:ui:icommandwindow#removelistitem|removeListItem]]
  * [[class:ui:icommandwindow#moveuplistitem|moveUpListItem]]
  * [[class:ui:icommandwindow#movedownlistitem|moveDownListItem]]
  * [[class:ui:icommandwindow#initlist|initList]]
  * [[class:ui:icommandwindow#getlistint|getListInt]]
  * [[class:ui:icommandwindow#getliststring|getListString]]
  * [[class:ui:icommandwindow#getlistitemvalue|getListItemValue]]
  * [[class:ui:icommandwindow#getlistitemrow|getListItemRow]]
  * [[class:ui:icommandwindow#getlistitemcount|getListItemCount]]
  * [[class:ui:icommandwindow#getlistcurrentrow|getListCurrentRow]]
  * [[class:ui:icommandwindow#getlistchecked|getListChecked]]
  * [[class:ui:icommandwindow#setlistcurrent|setListCurrent]]
  * [[class:ui:icommandwindow#setlistchecked|setListChecked]]
  * [[class:ui:icommandwindow#setliststring|setListString]]