力控组态软件ForceControl V7.0设置和操作后台组件时间调度的控件方法
PopDlg()
描述: 弹出配置对话框 .
返回值: 无 .
示例: a = #TimeScheduling.PopDlg();// 弹出配置对话框
SetEndTime(hour,min,sec,index)
描述: 设置时间调度设定的结束时间
返回值: int
0:成功设置时间调度设定的结束时间
-1:错误的设定的小时数
-2:错误的设定的分钟数
-3:错误的设定的秒数
-4:设定的结束时间小于时间调度的开始时间
-5:表示时间序号错误
参数: hour 为开始时间的小时数 (0-23)
min 为开始时间的分钟数 (0-59)
sec 为开始时间的秒数 (0-59)
index 表示时间调度序号,从 0 开始
说明: 设置时间调度设定的结束时间
示例: a = #TimeScheduling.SetEndTime(8,0,0,0); //设置第一时间调度的结束时间为(8:00:00)
SetITime(time,index)
描述: 设置时间调度设定的间隔时间
返回值: int
0:成功设置时间调度设定的间隔时间
-1:错误的设定的时间
-2:设定间隔时间无效(间隔时间 + 开始时间大于 24 小时)
参数: time 为间隔时间的秒数
index 表示时间序号 , 从 0 开始
示例: a = #TimeScheduling.SetITime(time,index);// 设置时间调度设定的间隔时间
SetLoopFlag(Flag,index)
描述: 设置时间调度设定的循环标记 .
返回值: int
0:成功
-1:循环标记错误
参数: Flag 标志位
0:该任务不能循环执行 ( 按照间隔时间连续运行 )
1:该任务可以循环执行按照间隔时间连续运行 )
index 表示时间调度的序号,从 0 开始
示例: a = TimeScheduling.SetLoopFlag(Flag,index);// 设置时间调度设定的循环标记
SetStartTime(hour,min,sec,index)
描述: 设置时间调度设定的开始时间
返回值: int
0:成功设置时间调度设定的开始时间
-1:错误的设定的小时数
-2:错误的设定的分钟数
-3:错误的设定的秒数
-4:设定的开始时间大于时间调度的结束时间
-5:时间序号错误
参数: hour 为开始时间的小时数 (0-23)
min 为开始时间的分钟数 (0-59)
sec 为开始时间的秒数 (0-59))
index 表示时间序号 , 从 0 开始
示例: a = #TimeScheduling.SetStartTime(8,0,0,0);// 设置第一个时间调度的开始时间为 (8:00:00).
SetType(type)
描述: 设置时间调度设定类型
返回值: int
0:成功设置时间调度设定类型
-1:错误的设定类型
参数: type 设定类型
0: 该时间调度每天都运行
1: 该时间调度每周都运行
2: 该时间调度每月都运行
说明: 设置时间调度设定类型
示例: a = #TimeScheduling.SetType(type );// 设置时间调度设定类型
SetVal(Val,type)
描述: 设置时间调度设定的日期数据 .
返回值: int
0:成功执行设置时间调度日期数据
-1:参数 Val( 日期数据 ) 设置错误
-2:参数 type 设置错误
参数: Val 为该时间调度设定的日期数据的高字 ( 高 16 位 ) 或低字 ( 低 16 位 ).
type 为设定时间调度值得类型
0:设定日期数据的低字 ( 低 16 位 )
1:设定日期数据的高字 ( 高 16 位 )
说明: 设置时间调度设定的日期数据
示例: a = #TimeScheduling.SetVal(127,0);// 设置时间调度设定的日期数据的低字为 127.
日期数据的格式:根据任务类型的不同,该内容数据表示不一样
任务类型 数据表示
// 每天 无意义
// 每周 低 7 位有意义(0 位表示周一,1 位表示周二 … 以此类推)
// 每月 低 31 位有意义 (0 位表示当月的 1 号,1 位表示当月的 2 号 … 以此类推,最高位 (31 位 ) 为最后一天标志位 )
Start()
描述: 时间调度开始启动
返回值: int
0:该时间调度开始启动
-1:该时间调度已经启动
-11:设置开始时间(SetStartTime 函数)错误
-21:设置时间调度类型(SetType 函数)错误
-31:设置时间调度数据(SetVal 函数)错误
-41:设置时间调度循环类型(SetLoopFlag 函数)错误
-51:设置时间调度间隔时间(SetITime 函数)错误
-61:设置时间调度结束时间(SetEndTime 函数)错误
参数: 无
说明: 一般该函数是在调用 Stop 函数将时间调度停止后再调用,时间调度会在力控运行系统启
动后自动运行。
示例: a = #TimeScheduling.Start( );// 时间调度开始启动
Stop()
描述: 中止正在运行的时间调度 .
返回值: int
0:中止时间调度成功
参数: 无
说明: 将正在运行的时间调度中止,以便于设置时间调度的方法和属性。
示例: a = #TimeScheduling.Stop();// 中止时间调度