作者： dashi

力控组态软件ForceControl V7.0后台组件语音报警的控件属性和控件方法

语音报警控件的控件属性
Rate
描述： 设置语速
类型： 整型
说明： nRate 为播音的快慢，取值范围为 -10 到 10 之间 , 以 1 的倍数增减。
示例： #AlarmSound.nRate = 8;// 设置语速为 8

Volume
描述： 设置音量
类型： 整型
说明： nVolume 为声音的大小，取值范围为 0 到 100 之间 , 以 10 的单位增减。
示例： #AlarmSound.nVolume = 90;// 设置音量为 90

语音报警控件 控件方法
CancelCurPlay()
描述： 取消当前正在播放的报警，播放下一个报警
返回值： 无
参数： 无
说明： 取消当前正在播放的报警，播放下一个报警
示例： #AlarmSound.CancelCurPlay();

CancelPlayList()
描述： 清除正在播放的报警语音队列 , 等待播放新的报警语音
返回值： 无
参数： 无
说明： 清除正在播放的报警语音队列 , 等待播放新的报警语音
示例： #AlarmSound.CancelPlayList();

Read(string strvalue)
描述： 读取指定字符串
返回值： 无
参数： strvalue 为读音的内容，可由英文、中文和数字组成。
说明： 播音
示例： #AlarmSound.Read(” 这是一个语音播报文字的方法 “);

SetVoice(int nValue)
描述： 设置是否播放报警语音
返回值： void
参数： nValue 设置的参数
说明： 当 nValue = 0 时，播放报警语音，否则不播放报警语音
Skip(int nvalue)
描述： 跳过当前正在播放的语音
返回值： 无
参数： nvalue- 跳过语音数，从 0 开始
0- 跳过当前正在播放的语音，并将该语音重新播放一次
1- 跳过当前正在播放的语音，并播放第二个语音
2- 跳过当前正在播放的语音，并播放第三个语音
说明 : 跳过当前正在播放的语音
示例： #AlarmSound.Skip(0);// 跳过当前正在播放的语音，并将该语音重新播放一次

力控组态软件ForceControl V7.0后台组件报警中心的控件方法

AckGroup(int nGroup)
描述： 确认组报警
返回值： int(0 失败，1 成功 )
参数： nGroup 报警组号 (0-99)
说明： 确认数据库报警组
示例： AckGroup(1);// 确认 1 报警组

AckLay(string LayName)
描述： 确认层报警
返回值： int(0 失败，1 成功 )
参数： LayName 要确认的数据库层 ( 为空时表示确认所有报警 )
说明： 确认数据库层报警
示例： AckLay(” 车间 1″);// 确认数据库车间 1 层下的所有报警
AckTag(string TagName, int nType)
描述： 确认点报警
返回值： int(0 失败，1 成功 )
参数： TagName 要确认的数据库点
nType 确认的报警类型 (0 全部报警，1 越限报警，2 变化率报警，3 偏差报警 )
说明： 确认数据库点报警
示例： AckTag(“tag1”,1);// 确认 tag1 的越限报警

GetNewAlarm()
函数 : int GetNewAlarm(int Time,int Milli,string csTagName,float fData,float fLimit,string csAlmType,int iPrio,string iGroup,int iAck,string szOper,string szInfo1,string szInfo2,string szInfo3,string szInfo4,string szInfo5,string szInfo6,string szInfo7,string szInfo8,string szInfo9,string szInfo10,int nCount);
描述： 获取最新的报警信息
返回值： int(0 失败，1 成功 )
参数： Time 时间，Milli 毫秒，csTagName 位号，fData 数值 ,fLimit 限值 ,csAlmType 类型 ,iPrio
级别 ,iGroup 报警组 ,iAck 确认 ,szOper 操作员 ,szInfo1-10 标签 ,nCount 计数器
说明： nCount 保存计数，用上次值和这次值进行比较，从而知道最新报警是否改变过 , 处理相应的逻辑。
示例： #AlarmCenter.GetNewAlarm(Time,Milli,csTagName,fData,fLimit,csAlmType,iPrio,iGroup,iAck,szOper,szInfo1,szInfo2,szInfo3,szInfo4,szInfo5,szInfo6,szInfo7,szInfo8,szInfo9,szInfo10,nCount);

GetCurAlarm()
函数： int GetCurAlarm(string szInfo,int nCount);
描述： 获取最新的报警信息
返回值 ： int(0 失败，1 成功 )
参数： szInfo 报警内容 ,nCount 计数器
说明： nCount 保存计数，用上次值和这次值进行比较，从而知道最新报警是否改变过 , 处理相应的逻辑。
示例： #AlarmCenter.GetCurAlarm(szInfo,nCount);// 获取最新报警

力控组态软件ForceControl V7.0后台组件历史数据中心的控件方法

Begin()
描述： 启动批量数据查询
返回值： void
参数： 无
说明： 启动批量数据查询
示例： #HisDataCenter.Begin()

Clear()
描述： 清除已查询的数据
返回值： void
参数： 无
说明： 清除已查询的数据
示例： #HisDataCenter.Clear()

End()
描述： 结束批量数据查询
返回值： void
参数： 无
说明： 结束批量数据查询
示例： #HisDataCenter.End()

GetHisData(Var,Year,Month,Day,Hour,Minute,Second)
描述： 获取指定时刻的历史值（使用该函数前应先调用 Begind()，调用结束后调用 End()）
返回值： float
参数： Var：欲存取的变量，必须为 DB 变量名称。
Year：整型，表示年，范围 1999~2037 。0 表示当年。
Month ：整型，表示月，范围 1~12。0 表示当月。
Day ：整型，表示日，范围 1~31。0 表示当天。负值表示前多少天，如 -1 表示前 1 天…
Hour ：整型，表示小时，范围 0~23。负值表示前多少小时，如 -1 表示前 1 小时
Minute：整型，表示分，范围 0~59。负值表示前多少分钟，如 -1 表示前 1 分钟…
Second：整型，表示秒，范围 0~59。负值表示前多少秒，如 -1 表示前 1 秒…
说明： 获取指定时间的历史值
示例： 1）val =#HisDataCenter.GetHisData(“FI101.PV”,2000,12,21,10,0,0);
取点 FI101.PV 在 2000 年 12 月 21 日 10 时 0 分 0 秒的历史数据。
2）val = #HisDataCenter.GetHisData(“FI101.PV”,0,0,-1,10,0,0);
取点 FI101.PV 在本年本月昨日 10 时 0 分 0 秒的历史数据。

GetStatisData(Var,Year, Month, Day, Hour,TimeSpan,Type,Time)
描述： 获取指定时刻的统计值 ( 使用该函数前应该先调用 Begind(), 调用结束后调用 End())
返回值： float
参数： Year, Month, Day, Hour 指定的是开始时间，TimeSpan 指定的是时间长度。
Var 欲存取的变量，该变量必须是 DB 变量名称。
Year : 整型，表示年 , 范围 1999~2037 。0 表示当年。
Month: 整型，表示月 , 范围 1~12。0 表示当月。
Day: 整型，表示日 , 范围 1~31。0 表示当天，负值表示前多少天，如 -1 表示前 1 天，-2表示前 2 天…。
Hour: 整型，表示时 , 范围 0~23。 负值表示前多少小时，如 -1 表示前 1 小时，-2 表示前 2 小时…。
TimeSpan: 整型，为时间范围，单位为小时。如果 Hour 为 8，TimeSpan 为 1，表示7 点 ~8 点的统计数据（注意：对应于数据表中 8 点的数据），即后一个小时的统计数据；
如果 TimeSpan 为 2，则表示 6 点 ~8 点的统计数据，即前 2 个小时的统计数据。
Flag: 表示取何种统计数据。0：平均值； 1: 最大值 2: 最小值。
Time: 字符型变量，为达到最大 / 最小值的时间。
说明： 获取指定时间的统计值
示例：val=#HisDataCenter.GetStatisData(“FI101.PV”,2000,12,21,10,1,0,strTime);
取数据库中的点 FI101.PV 在 2000 年 12 月 21 日 10~11 时的平均值。
val = #HisDataCenter.GetStatisData (“FI101.PV”,0,0,-1,10, 2，1,strTime);
取数据库中的点 FI101.PV 在本年本月昨日 8~10 时的最大值。
val = #HisDataCenter.GetStatisData (“FI101.PV”,0,0,-1,18, 3，2,strTime);
取数据库中的点 FI101.PV 在本年本月昨日 16~18 时的最小值。