力控组态软件ForceControl V7.0 Windows 控件 日期控件的方法和事件

日期控件用来指定日期，用户通过它的属性、方法可以方便的设置、获取其数据。此控件与时间范围控件配合使用，在力控组态软件的工程中需要时间处理的地方具有广泛的应用。

1参数设置

进行参数设置时首先通过图1所示的方法从力控软件的菜单栏点击工具选择windows控件，在windows控件选择时间。然后在画面上放置在合适的位置上。

图1

双击时间控件或者右键再弹出菜单里选择对象属性。弹出如图2所示的参数设置对话框。选择不同的风格设置将显示不一样的日期格式。

图2

2时间控件的属性

year
功能：控件的年参数。
语法：#name.Year = nValue。
说明：nValue为整型，1970~2037的整数。
示例：#name.Year = 2006;//2006年。

month
功能：控件的月参数。
语法：#name.Month= nValue。
说明：nValue为整型，1~12的整数。
示例：#name.Month = 11;//11月。

day
功能：控件的日参数。
语法：#name.Day= nValue。
说明：nValue为整型，1~31的整数。
示例：#name.Day = 5;//5日。

hour
功能：控件的时参数。
语法：#name.Hour= nValue。
说明：nValue为整型，0~23的整数。
示例：#name.Hour= 5;//5时。

minute
功能：控件的分参数。
语法：#name.Minute= nValue。
说明：nValue为整型，0~59的整数。
示例：#name.Minute= 5;//5分。

second
功能：控件的秒参数。62
语法：#name.Second= nValue。
说明：nValue为整型，0~59的整数。
示例：#name.Second= 5;//5秒。

DayOfWeek
功能：星期
语法：#name.DayOfWeek= nValue
说明：nValue为整型，只读属性，0~6的整数
示例：#name.Day OfWeek= 5;//星期五

2时间控件的方法

SetTime
功能：设置控件时间。
语法：#name.SetTime(Time)。
参数：Time为整型，开始时刻以自1970年1月1日零时逝去的秒数来计算。该值可以
通过字符串形式的时间调用函数LongTime来得到。也可以通过相对于系统变
量当前时间$CurTime来计算。
返回值：无。
示例：#name.SetTime(LongTime(“2002/1/18 8:50:00”));// 设置时间2002/1/18 8:50:00。
#name.SetTime($CurTime – 3600); //设置当前时刻前一个
小时的时间。

GetTime
功能：取得控件时间。
语法：#name.GetTime()。
返回值：开始时刻以自1970年1月1日八时(时区决定)逝去的秒数来计算。返回整型。
若为之前的时间则返回-1。该值可以通过函数StrTime转成字符串形式的时间
示例：#name.GetTime();// 取得自1970年1月1日零时逝去的时间秒数。

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

力控组态软件ForceControl V7.0 下拉框控件的事件

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

力控组态软件ForceControl V7.0 下拉框控件的方法

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

GetWindowsText
功能：获取编辑框中的内容。
语法：#name.GetWindowsText()。
返回值：字符型。
示例：#name.GetWindowsText();// 返回编辑框中的内容。

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

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

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

ListFindItem
功能：查找与文本串Text相匹配的索引项。
语法：#name.ListFindItem(Index,Text)。
说明：Text为字符串，要查找的文本串。索引号从0开始，-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表示无选择。
返回值：字符串。
示例：#name.ListGetItem(1);// 返回索引号为1的项目字符串信息。

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

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

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文件。

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

力控组态软件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的项目字符串信息。