力控组态软件ForceControl V7.0的变量操作函数2

GetTagKind
语法int GetTagKind(“TagName”,nDataSource)
说明获取点类型，即得到点在实时数据库中的类型号
参数TagName: 点名称，字符串变量或常量。
nDataSource : 整型，数据源序号，数据源序号以0开始，注意该序号会因
数据源的删减而变动。
返回值点类型号，整型
示例KIND = GetTagKind(“FI1001”,0);

GetVar
语法float GetVar(strVarName)
说明返回指定数据库变量参数的值。
返回值float 返回数据库变量数值型参数的值。
参数string:指定数据库变量需要取值的参数名称。
示例float dVar=GetVar(“Tag0.PV”);
/ /返回Tag0的PV值，并赋给变量名为dVar的浮点型变量。

GetVarStr
语法string GetVarStr(strVarName)
说明返回指定数据库变量参数的值。
返回值string 返回数据库变量字符型型参数的值。
参数string:指定数据库变量需要取值的参数名称。
示例string strVar=GetVarStr(“Tag0.DESC”);
//返回Tag0的DESC值，并赋给变量名为strVar的字符型变量。

InsertHisData
语法sertHisData (Var, Data, Year,Month,Day,Hour,Minute,Second,Millisec)
说明向数据库中插入历史数据
参数Var: 该参数不能包含在””中。数据库变量，该变量的数据源指明了向哪个
数据库插入数据，而其数据库参数指明了是数据库的哪点参数。必须为数
值型变量。注意：要插入的值不是Var变量的当前值，而是下一个参数Data。
Data:要插入的数值，为数值型变量，常量或表达式。
参数Year,Month,Day,Hour,Minute,Second, Millisec用于指定将要插入的历史
数据发生时刻。即历史数据时间插入点。
Year :整型，表示年,范围1999～2037 。0表示当年。
Month: 整型，表示月, 范围1～12。0表示当月。
Day: 整型，表示日, 范围1～31。0表示当天，负值表示前多少天，如-1 表
示前1天，-2 表示前2天…。
Hour: 整型，表示时, 范围0～23。负值表示前多少小时，如-1 表示前1小
时，-2 表示前2小时…。
Minute: 整型， 表示分, 范围0～59。负值表示前多少分钟，如-1 表示前1
分钟，-2 表示前2分钟…。
Second:表示秒, 范围0～59。负值表示前多少秒，如-1 表示前1秒，-2 表
示前2秒…。
示例1）InsertHisData(FI101.PV,50.5,2000,12,21,10,0,0,0);//向数据库中插入的点
为FI101.PV，数值为50.5，时间为2000年12月21日10时0分0秒0毫秒。
2) InsertHisData (FI101.PV, 75.0, 0,0,-1,10,0,0,100);//向数据库中插入的点
为FI101.PV，数值为75.00, 时间为在本年本月昨日10时00分00秒100毫秒。

SetHisDataState
语法SetHisDataState（state type）
说明设置取历史数据函数的错误返回值的状态值。当调用GetHisData时如果取
值时间为不存在的值时,按照此函数的设置值返回不同的结果。
参数StateType:状态类型。
0 ： 调用GetHisData时如果取值时间为不存在的值时,返回最后的有效值
1 ： 调用GetHisData时如果取值时间为不存在的值时,返回-9999.0
2 ： 调用GetHisData时如果取值时间为不存在的值时,返回0值
备注此函数设置一次，整个运行期间的工程起作用。工程的默认值为0，如果想
修改GetHisData的返回值状态最好在每次调用前使用或者在工程启动时设
置一次。