力控组态软件ForceControl V7.0  Windows 控件  下拉列表 控件的方法和事件

力控组态软件 下拉列表 控件的事件

Click
名称：Click
功能：鼠标单击事件
返回值：void
参数：nIndex-选中的序号
说明：鼠标单击执行相关自定义脚本函数。

DbClick
名称：DbClick
功能：鼠标双击事件
返回值：void
参数：nIndex-选中的序号
说明：鼠标双击执行相关自定义脚本函数。

Change
名称：Change
功能：数据改变事件
返回值：void
参数：nOldSel-改变前选中行，nNewSel-改变选中行
说明：选中行发生改变执行相关自定义脚本函数。

力控组态软件 下拉列表 控件的方法

GetListCount
功能：获取列表中元素的个数
语法：int GetListCount()
返回值：int,列表中元素的个数
示例：#name.GetListCount()

IsCurSelection
功能：查看所给索引号的项是否被选中。
语法：#name.IsCurSelection(index)。
返回值：整型。选中为1，未选中为0。
说明：index为整型,从0开始，列表框风格为“多选”或“多选扩展”时有效。
示例：#name.IsCurSelection(2);//返回索引号为2的项是否被选中。

ListInsertItem
功能：指定位置插入对象。
语法：#name.ListInsertItem(nIndex,Text)。
参数：nIndex为选择项索引号，类型为整型，成员项索引号，索引号从0开始Text为
要设置的值，类型为字符串。
返回值：无。
示例：#name.ListInsertItem(0， “abc”);//索引号为0的项为“abc” 。

ListLoad
功能：从指定的文件中装载列表框。
语法：#name.ListLoad(FileName)。
参数：FileName为字符串，要读取的文件名称，缺省文件路径为应用目录下的
UserDat子目录。文件格式参见ListSave。
返回值：无。
示例：#name.ListLoad(“C:\a.txt”);// 将C盘目录下的a.txt文件装载到列表框中。

ListSave
功能：将列表框中的内容存盘。
语法：#name.ListSave(FileName)。
参数：FileName为字符串，要保存的文件名称，缺省文件路径为应用目录下的
UserDat子目录。
存储的内容包括列表框中项数，文本串及数值。存储格式为文本格式。记录
格式为：

<?xml version=”1.0″ encoding=”gb2312″?>；
<XML Count=”2″>；
<Node0 Content0=”List1″ ItemData0=”0″>Node0</Node0>；
<Node1 Content1=”List2″ ItemData1=”1″>Node1</Node1>；
</XML>；
返回值

返回值：无
示例：#name.ListSave(“C:\a.txt”);// 将列表框中的内容存为C盘目录下的a.txt文件。

ListSetItemData
功能：设置索引号为Index的成员项相关联的数据值。
语法：#name.ListSetItemData (Index,Data)。
参数：Index为选择项索引号，整型。索引号从0开始，-1表示无选择，Data为数值。
返回值：无。
示例：#name.ListSetItemData(1,70);// 设置索引号为1的成员项关联的值为70。

ListGetItemData
功能：取索引号为Index的成员项相关联的的数据值。
语法：name.ListGetItemData(Index)。
参数：Index为选择项索引号，类型为整型。索引号从0开始，-1表示无选择。
返回值：相关联的的数据值。
示例：#name.ListGetItemData(1);// 返回索引号为1的成员项相关联的数据值。

ListAddItem
功能：添加一行文本为列表框项。Text为字符串，要添加的项目的文本串。
语法：#name. ListAddItem (Text)
返回值：无。
示例：#name.ListAddItem (“abc”);// 在列表后面添加”abc”。

ListClear
功能：删除列表框中所有项。
语法：#name.ListClear()。
返回值：无。
示例：#name.ListClear();// 列表框中所有项被删除。

ListDeleteItem
功能：删除列表框中指定的成员项。
语法：#name.ListDeleteItem(index)。
参数：index为整型，成员项索引号，索引号从0开始。
返回值：无。
示例：#name.ListDeleteItem(0);// 删除列表框中索引号为0的成员项。

ListFindItem
功能：查找与文本串Text相匹配的索引项。
语法：#name.ListFindItem(Index,Text)。
参数：Text为字符串，要查找的文本串。索引号从Index开始，-1表示未找到。
返回值：int,返回strText的索引号,-1表示未找到
示例：#name.ListFindItem (0,”abc”);//从索引号0开始，返回与文本串abc相匹配的索引
项。

ListGetSelection
功能：获取当前选择项的索引号。
语法：#name.ListGetSelection()。
返回值：索引号从0开始，-1表示无选择。
示例：#name.ListGetSelection();// 返回当前选择项的索引号。

ListSetSelection
功能：设置当前选择项。
语法：#name.ListSetSelection(Index)。
参数：列表框风格为普通有效。Index为选择项索引号，类型为整型。索引号从0开
始，-1表示无选择。
返回值：无。
示例：#name.ListSetSelection(1);// 设置当前选择项为1。

ListGetItem
功能：获取索引号为Index的项目字符串信息。
语法：#name.ListGetItem(Index)
参数：Index为选择项索引号，类型为整型。索引号从0开始，-1表示无选择。
返回值：索引号为Index的项目字符串信息。
示例：#name.ListGetItem(1);// 返回索引号为1的项目字符串信息。