Navigation:  iCentroview系统的配置 > 配置客户端 > 服务端配置 > SCADA节点总览配置 > 历史趋势配置 > 历史趋势控件提供的接口

u添加曲线到当前运行组

u删除当前运行组中的曲线

u删除当前运行组内所有曲线

u删除组内所有曲线并添加新曲线

u初始化趋势控件

u释放趋势控件占用的资源

u显示指定组的曲线

u显示/隐藏工具栏

u设置曲线对应的限制线

u删除限制线

u保存当前曲线显示隐藏状态到配置文件

u加载配置文件修改曲线显示隐藏状态

u动态增加（修改）曲线

u动态增加（修改）曲线（可配置显示效果）

u设置趋势图起止时间

u设置曲线的显示隐藏状态

u设置是否显示曲线tips

 

以下是工具栏按钮功能接口：

u向前翻页

u向后翻页

u按比例向前翻页

u按比例向后翻页

u保存当前图片

u设置是否刷新

u打开曲线显示/隐藏设置界面

u打开趋势图配置界面

u打开打印设置界面

u打开设置起止时间界面

u设置放大/恢复状态

u回到当前页

u打开趋势组选择界面

u设置ihd运行时动态选点

u显示多Y轴

u设定Y轴坐标的接口

---

uAddCurve(tagname)

功能描述：

将该变量添加到当前运行组，曲线名称为变量名，该脚本及特殊属性添加曲线时都不再限制曲线名，可以随便命名，曲线名的字符串允许包含#等特殊字符

 

参数说明：

tagname：要添加的变量名称

 

uDeleteCurve(tagname)

功能描述：

将该变量从当前运行组中删除

 

参数说明：

tagname：要添加的变量名称

 

uDelAllCurves()

功能描述：

将组内所有曲线删除

 

uReplaceWithCurve(tagname)

功能描述：

将组内曲线全部删除，添加新曲线

 

参数说明：

tagname：要添加的变量名称

 

uStartRunMode()

功能描述：

在组态页面OnLoad时调用，初始化环境

 

uStopRunMode()

功能描述：

在组态页面OnUnLoad时调用，释放资源

 

uSelectGrpByName(GroupName)

功能描述：

显示指定组的曲线

 

参数说明：

GroupName：要显示的组名

 

uvoid ShowToolBar(const VARIANT FAR& bShow)

功能描述：

显示/隐藏工具栏

 

参数说明：

bShow：0，隐藏；1，显示

 

代码示例：

Sub BSButton15_OnClick()

itrend1.ShowToolBar 1

End Sub

 

uvoid SetLimitLine(LPCTSTR strName, const VARIANT FAR& nLineType, OLE_COLOR clrLine, const VARIANT FAR& dbValue)

功能描述：

设置曲线对应的限制线

 

参数说明：

strName：曲线名； nLineType：0上限，1下限

clrLine：颜色；dbValue：值

 

代码示例：

Sub BSButton21_OnClick()

itrend1.SetLimitLine "curve0",0,RGB(0,0,0),100

End Sub

 

uvoid DeleteLimitLine(LPCTSTR strName, const VARIANT FAR& nLineType);

功能描述：

删除限制线

 

参数说：

strName：曲线名； nLineType：0上限，1下限

 

代码示例：

Sub BSButton22_OnClick()

itrend1.DeleteLimitLine "curve0", 0

End Sub

 

uBOOL SaveCurveShowFile(LPCTSTR strFileName)

功能描述：

保存当前曲线显示隐藏状态到配置文件。文件路径：icv安装路径Executable /Config。

 

文件格式：

<?xml version="1.0" encoding="gb2312" ?>

<cvtrend>

    <curves showcount="3">

         <curve name="trend1" />

         <curve name="trend2" />

         <curve name="trend3" />

   </curves>

</cvtrend>

 

代码示例：

Sub BSButton19_OnClick()

itrend1.SaveCurveShowFile "aa.txt"

End Sub

 

uBOOL LoadCurveShowFile(LPCTSTR strFileName)

功能描述：

加载配置文件修改曲线显示隐藏状态

 

文件格式：

<?xml version="1.0" encoding="gb2312" ?>

<cvtrend>

    <curves showcount="3">

         <curve name="trend1" />

         <curve name="trend2" />

         <curve name="trend3" />

   </curves>

</cvtrend>

 

代码示例：

Sub BSButton20_OnClick()

itrend1.LoadCurveShowFile "aa.txt"

End Sub

 

ulong AddCurveName(LPCTSTR strTagName, LPCTSTR strCurveName)

功能描述：动态增加曲线。若该曲线名称已经存在，则替换该曲线对应的tag点。

 

参数说明：

strTagName ： 变量名

strCurveName ： 曲线名

 

代码示例：

Sub BSButton23_OnClick()

itrend1.AddCurveName "added_scadaname1.aaa_2","addcurve"

End Sub

 

ulong AddCurveName(LPCTSTR strTagName,LPCTSTR strCurveName,nLineType,clrLine)

功能描述：动态增加曲线，可以设置曲线的效果。若该曲线名称已经存在，则替换该曲线对应的tag点及显示效果

 

参数说明：

strTagName ： 变量名

strCurveName ： 曲线名

nLineType：曲线线型。值为0-19，从上到下依次排序，效果如下图：

clrLine：曲线颜色。为:RGB(X,X,X)。

 

代码示例：

Sub BSButton23_OnClick()

itrend1.AddCurveName "added_scadaname1.aaa_2","addcurve",0,RGB(0,255,0)

End Sub

 

ulong SetTrendTime(const VARIANT FAR& strStartTime, const VARIANT FAR& strEndTime)

功能描述：设置趋势图起止时间

 

代码示例：

Sub BSButton24_OnClick()

itrend1.SetTrendTime "2013-11-18 10:00:00", "2013-11-18 10:10:00"

End Sub

 

uvoid SetCurveShow(LPCTSTR strCurveName, const VARIANT FAR& bShow)

功能描述：设置曲线的显示隐藏状态

 

参数说明：

strCurveName：曲线名，在当前显示组内

bShow：0：隐藏；1：显示

 

代码示例：

Sub BSButton27_OnClick()

itrend1.SetCurveShow "curve0", 1

End Sub

 

uvoid ShowCurveTips( const VARIANT bShow)

功能描述：设置是否显示曲线tips

 

参数说明：

bShow：0：隐藏；1：显示当前鼠标指向曲线的信息，2：显示当前时刻所有曲线的信息

 

代码示例：

Sub BSButton27_OnClick()

itrend1.ShowCurveTips  1

End Sub

 

以下是工具栏按钮功能接口：

 

ulong PrevPage(const VARIANT FAR& nPrev) 往前翻nPrev页，参考功能前后翻页

脚本示例：

Sub BSButton4_OnClick()

itrend1.PrevPage 3

End Sub

 

ulong NextPage(const VARIANT FAR& nNext) 往后翻nNext页，参考功能前后翻页

脚本示例：

Sub BSButton3_OnClick()

itrend1.NextPage 2

End Sub

 

ulong PartPrevPage(const VARIANT FAR& nPrev) 按比例往前翻nPrev页

脚本示例：

Sub BSButton5_OnClick()

itrend1.PartPrevPage (1)

End Sub

 

ulong PartNextPage(const VARIANT FAR& nNext) 按比例往后翻nNext页

脚本示例：

Sub BSButton6_OnClick()

itrend1.PartNextPage (1)

End Sub

 

ulong TrendCopyJpegToFile() 保存当前图片

脚本示例：

Sub BSButton17_OnClick()

itrend1.TrendCopyJpegToFile

End Sub

 

ulong SetTrendRefresh(const VARIANT FAR& bRefresh) 设置是否刷新，参考功能启动停止刷新

bRefresh-- 0 停止刷新 1 开始刷新

脚本示例：

Sub BSButton11_OnClick()

itrend1.SetTrendRefresh 0

End Sub

 

ulong SetCurveStatusUI() 设置曲线显示/隐藏界面方法，参考界面显示或隐藏曲线

脚本示例：

Sub BSButton8_OnClick()

itrend1.SetCurveStatusUI

End Sub

 

uvoid OpenPEConfigDlg() 趋势图配置，参考界面趋势图配置

脚本示例：

Sub BSButton9_OnClick()

itrend1.OpenPEConfigDlg

End Sub

 

ulong PEPrint() 打印，参考界面打印浏览

脚本示例：

Sub BSButton10_OnClick()

itrend1.PEPrint

End Sub

 

ulong SetTrendTimeUI() 设置起止时间界面方法，参考界面设置X轴显示时间

脚本示例：

Sub BSButton18_OnClick()

itrend1.SetTrendTimeUI

End Sub

 

uvoid TrendZoom(const VARIANT FAR& bZoomout) 设置放大/恢复状态 在查看历史趋势时才可以放大查看，参考界面放大恢复原状

bZoomout：0，设置放大；1，设置恢复

脚本示例：

 

Sub BSButton13_OnClick()

itrend1.TrendZoom 0

End Sub

 

uvoid CurrentPage() 回到当前页

脚本示例：

Sub BSButton2_OnClick()

itrend1.CurrentPage()

End Sub

 

uvoid SelectGroupUI() 组选择界面方法,界面参考动态选择组

脚本示例：

Sub BSButton7_OnClick()

itrend1.SelectGroupUI()

End Sub

 

ulong SetRunTimeCfgEnabled (const VARIANT FAR& bEnabled) 设置ihd运行时动态选点

脚本示例：

Sub BSButton5_OnClick()

itrend1. SetRunTimeCfgEnabled (1)

End Sub

 

设为1的情况下，在运行时选择工具栏中的趋势图配置，点击特殊属性页，可以配置ihd曲线信息

 

uvoid ShowCurveOwnYaxis(const VARIANT FAR& bYaxis) 是否显示多Y轴

bYaxis  1--->显示多y轴；0--->不显示多y轴；

脚本示例：

Sub page_OnLoad()

itrend1. ShowCurveOwnYaxis (1)

End Sub

 

uvoid SetYAxisScale(const VARIANT FAR& bAuto, const VARIANT FAR& dbHighLimit, const VARIANT FAR& dbLowLimit, const VARIANT FAR& nGridNum)

功能描述：设定Y轴坐标的接口

参数1：BOOL bAuto，是否自适应，如果为1的话，则后面的参数无效

参数2：double dbHighLimt，上限

参数3：double dbLowLimit,下限

参数4： int nGridNum，间隔数

 

脚本示例：

Sub BSButton39_OnClick()

itrend1.SetYAxisScale 0,200,20,10

End Sub