学控制

力控组态软件ForceControl V7.0曲线控件 趋势曲线（实时、历史）的方法1

AddAlarmRegion
功能： 增加指定曲线的报警区域。
语法： AddAlarmRegion(/int/nCurveIndex,/string/regName,/double/dbLow,
/double/dbHigh,/int/clrReg);
返回值： int 返回报警区域的索引号（从 1 开始）。
参数： nCurveIndex- 指定曲线索引号。
regName- 报警区域名称。
dbLow- 下限。
dbHigh- 上限。
clrReg- 颜色。
说明： 参数依次为曲线索引号、报警区域名称、下限、上限、颜色。如添加成功，则返回该报警区域的索引号（从 1 开始）。
示例： #ObjectEx.AddAlarmRegion(/int/1,/string/”regName”,/double/5,/double/40,
/int/12);

AddCurve
功能： 添加新的曲线，各种曲线配置采用系统默认值。
语法： AddCurve(/string/varname);
返回值： 该曲线的索引号（从 1 开始），失败返回 0。
参数： varname- 曲线关联变量。
说明： 添加新的曲线，参数分别为 Y 轴对应的变量，如 “tag1.PV”。
示例： #ObjectEx.AddCurve(/string/”a5.PV”);

AddCurveEx
功能： 增加曲线。
语法： #SuperCurve.AddCurveEx(/string/CurveDesc,/double/
tBegainTime,/double/tTimeLen,/string/yname,/double/yLow,/double/yHigh);
说明： 返回值为该曲线的索引号（从 1 开始），添加失败则返回 0。
参数： CurveDesc : 曲线描述。
tBegainTime：开始时间，整数型时间。
tTimeLen：时间长度，单位 s。
yname ：Y 轴变量。
yLow ：Y 轴变量的低限。
yHigh ：Y 轴变量的高限。
示例： nLineIndex=#SuperCurve.AddCurveEx(“曲线 1″,LongTime(“2007/01/01 14:50:48″),600,”tag1.pv”,0,100);// 添加曲线 1, 关联变量为 tag1.pv，开始时间是”2007/01/01 14:50:48″，时间长度 600s，Y 轴范围 0-100。

力控组态软件 ForceControl V7.0 曲线控件 趋势曲线（实时、历史）的属性

DrawBk
功能： 是否绘制背景色。
语法： #ObjectEx. DrawBk= nValue。
说明： nValue 为整型，1 绘制，0 不绘制；

DrawFrame
功能： 绘制边框。
语法： #ObjectEx. DrawFrame = nValue。
说明： nValue 为整型，1 绘制，0 不绘制；

DrawXGrid
功能： 是否绘制 X 轴网格。
语法： #ObjectEx. DrawXGrid = nValue。
说明： nValue 为整型，1 绘制，0 不绘制；

DrawYGrid
功能： 是否绘制 Y 轴网格。
语法： #ObjectEx. DrawYGrid = nValue。
说明： nValue 为整型，1 绘制，0 不绘制；

MousePan
功能： 是否允许鼠标平移。
语法： #ObjectEx. MousePan = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为不允许鼠标平移，该值为 1 或者 TRUE 为允许
鼠标平移，MousePan 和 MouseZoom 只能有一个为 1。

MouseZoom
功能： 是否允许鼠标缩放。
语法： #ObjectEx. MouseZoom = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为不允许鼠标缩放，该值为 1 或者 TRUE 为允许鼠标缩放，MousePan 和 MouseZoom 只能有一个为 1。

MultiXAxis
功能： 是否允许多横轴显示。
语法： #ObjectEx. MultiXAxis = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为不允许多横轴，该值为 1 或者 TRUE 为允许多横轴。

MultiYAxis
功能： 是否允许多纵轴显示。
语法： #ObjectEx. MultiYAxis = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为不允许多纵轴，该值为 1 或者 TRUE 为允许多纵轴。

RightYAxis
功能： 纵轴右显示。
语法： #ObjectEx. RightYAxis = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为纵轴左显示，该值为 1 或者 TRUE 为纵轴右显示。

ShowDlg
功能： 允许鼠标双击时显示设置对话框。
语法： #ObjectEx. ShowDlg = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为不允许鼠标双击时显示对话框，该值为 1 或者TRUE 为允许鼠标双击时显示对话框。

ShowLegend
功能： 是否允许显示图例。
语法： #ObjectEx. ShowLegend = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为不允许显示图例，该值为 1 或者 TRUE 为允许显示图例。

ShowPercentage
功能： 是否采用百分比坐标。
语法： #ObjectEx. ShowPercentage = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为绝对值显示，该值为 1 或者 TRUE 为百分比显示。

SlidColor
功能： 游标颜色 。
语法： #ObjectEx. SlidColor = nValue。
说明： nValue 为颜色索引号（索引号在颜色选择框，左上角序号为 0，往下每行依次加 32）。
取值范围：0~255。

TimeColor
功能： 设置历史曲线时游标处曲线显示时间的颜色。
语法： #ObjectEx. TimeColor = nValue
说明： nValue 为颜色索引号（索引号在颜色选择框，左上角序号为 0，往下每行依次加 32）。
取值范围：0~255。

XAColor
功能： X 轴主刻度线颜色。
语法： #ObjectEx. XAColor = nValue。
说明： nValue 为颜色索引号（索引号在颜色选择框，左上角序号为 0，往下每行依次加 32）。
取值范围：0~255。

XASplit
功能： X 轴主刻度数。
语法： #ObjectEx. XASplit = nValue。
说明： nValue 为 X 轴主刻度数，整型。

XAxesPan
功能： X 轴是否允许平移。
语法： #ObjectEx. XAxesPan = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为不允许 X 轴平移，否则允许平移。

XAxesZoom
功能： X 轴是否允许缩放。
语法： #ObjectEx. XAxesZoom = nValue。
说明： nValue 为整型，该值为 0 或者 FALSE 为不允许 X 轴缩放，否则允许缩放

XBColor
功能： X 轴副刻度线颜色。
语法： #ObjectEx. XBColor = nValue。
说明： nValue 为颜色索引号（索引号在颜色选择框，左上角序号为 0，往下每行依次加 32）。
取值范围：0~255。

XBSplit
功能： X 轴副刻度数。
语法： #ObjectEx. XBSplit = nValue。
说明： nValue 为 X 轴副刻度数，整型。

YAColor
功能： Y 轴主刻度线颜色。
语法： #ObjectEx. YAColor = nValue。
说明： nValue 为颜色索引号（索引号在颜色选择框，左上角序号为 0，往下每行依次加32）。 取值范围：0~255。

YASplit
功能： Y 轴主刻度数。
语法： #ObjectEx. YAColor = nValue。
说明： nValue 为 Y 轴主刻度数，整型。

YAxesPan
功能： Y 轴是否允许平移。
语法： #ObjectEx. YAxesPan = nValue。
说明： nValue 整型，该值为 0 或者 FALSE 为不允许 Y 轴平移，否则允许平移。

YAxesZoom
功能： Y 轴是否允许缩放。
语法： #ObjectEx. YAxesZoom = nValue。
说明： nValue 为整型，该值为 0 或者 FALSE 为不允许 Y 轴缩放，否则允许缩放。

YBColor
功能： Y 轴副刻度线颜色。
语法： #ObjectEx. YBColor = nValue
说明： nValue 为颜色索引号（索引号在颜色选择框，左上角序号为 0，往下每行依次加 32）。
取值范围：0~255。

YBSplit
功能： Y 轴副刻度数。
语法： #ObjectEx. YBSplit = nValue。
说明： nValue 为 Y 轴副刻度数，整型。

XAxesBackward
功能： X 轴反向显示 ( 从左到右显示实时曲线 )
语法： #SuperCurve.XAxesBackward = NVALUE
说明： NVALUE 整型，该值为 0 或者 FALSE 为横轴正向显示 ( 从右到左显示实时曲线 )，该值为 1 或者 TRUE 为横轴反向显示 ( 从左到右显示实时曲线 )

DrawSlidLine
功能： 是否绘制游标线
语法： #SuperCurve.DrawSlidLine = NVALUE
说明： NVALUE 为整型，1 绘制，0 不绘制；

SelectColor
功能： 设置曲线选择框的颜色
语法： #SuperCurve.SelectColor = NVALUE
说明： NVALUE 为颜色索引号
SelectedCurveIndex
描述 : 当前选中曲线的索引号
类型 : ( 整型 )
说明 : 用于在配合其它函数获取当前选中曲线的信息。
功能 : 设置实时曲线初始化时是否先获取历史数据。

RealCurveInitGetHis
语法： #SuperCurve.RealCurveInitGetHis = NVALUE
说明： NVALUE = 1 实时曲线初始化先获取历史数据 , 然后在获取实时数据 ;
NVALUE = 0, 关闭此功能 , 实时曲线直接获取实时数据
注意 : 获取历史数据会导致实时曲线初始化过程变慢 ,web 上推荐关闭此功能

UnShowBadData
功能： 是否显示无效数据。
语法： #ObjectEx. UnShowBadData = n

力控组态软件 ForceControl V7.0 曲线控件棒图2的控件属性

UserLabel
功能： 是否自定义 Y 轴的刻度
语法： #BarChart.UserLabel=NVALUE
说明： NVALUE 为整型
示例： #BarChart.UserLabel=1;// 自定义 Y 轴的刻度

3DBar
功能： 棒图的形状
语法： #BarChart.3DBar=NVALUE
说明： NVALUE 为整型，1 表示棒图为 3D 形状，0 表示棒图为平面形状
示例： #BarChart.3DBar =1;// 设置棒图的形状为立体

SWAPXY
功能： 是否交换 XY 轴
语法： #BarChart.SWAPXY=NVALUE
说明： NVALUE 为整型
示例： #BarChart.WAPXY =1;// 交换 XY 轴

DownBarBackColor
功能： 棒图绘图区负棒图部分的背景颜色，如果棒图类型为单一棒图和复合棒图，该属性设置无效
语法： #BarChart.DownBarBackColor=NVALUE
说明： NVALUE 为力控颜色索引号
示例： #BarChart.DownBarBackColor =0;// 设置棒图绘图区负棒图部分的背景颜色为红色

DownBarBack
功能： 棒图绘图区负棒图部分的背景，如果棒图类型为单一棒图和复合棒图，该属性设置无效
语法： #BarChart.DownBarBack=NVALUE
说明： NVALUE 为整型
示例： #BarChart.DownBarBack =1

UpBarBackColor
功能： 棒图区的背景颜色，如果棒图类型为正负棒图，表示正棒图绘图区的背景颜色
语法： #BarChart.UpBarBackColor=NVALUE
说明： NVALUE 为力控颜色索引号
示例： #BarChart.UpBarBackColor =0;// 设置棒图绘图区正棒图部分的背景颜色为红色

UpBarBack
功能： 是否绘制棒图区的背景，如果棒图类型为正负棒图，表示是否绘制正棒图绘图区的背景
语法： #BarChart.UpBarBack=NVALUE
说明： NVALUE 为整型
示例： #BarChart.UpBarBack=1

BarFrameColor
功能： 棒图区的边框颜色
语法： #BarChart.BarFrameColor=NVALUE
说明： NVALUE 为力控颜色索引号
示例： #BarChart.BarFrameColor =0;// 设置棒图绘图区的边框颜色为红色

BarFrame
功能： 是否绘制棒图区的边框
语法： #BarChart.BarFrame=NVALUE
说明： NVALUE 为整型
示例： #BarChart.BarFrame=1

YAxisRight
功能： Y 轴是否右边显示
语法： #BarChart.YAxisRight=NVALUE
说明： NVALUE 为整型
示例： #BarChart.YAxisRight =1;// Y 轴右边显示

XLabel
功能： X 轴是否添加标签
语法： #BarChart.XLabel=NVALUE
说明： NVALUE 为整型
示例： #BarChart. XLabel=0;// X 轴标签不显示

YAxisName
功能： Y 轴的名字
语法： #BarChart.YAxisName=SVALUE
说明： SVALUE 为字符型
示例： #BarChart.YAxisName =’’BarChart”;

XAxisName
功能： X 轴的名字
语法： #BarChart.XAxisName=SVALUE
说明： SVALUE 为字符型
示例： #BarChart.XAxisName =’’BarChart”;

Title
功能： 棒图的标题
语法： #BarChart.Title=SVALUE
说明： SVALUE 为字符型
示例： #BarChart.Title =’’BarChart”;

TimeFormat
描述： X 轴标签显示格式
类型： int
说明： 真 -X 轴以时间格式显示标签；假 – X 轴以数字格式显示标签。
示例： #name.TimeFormat=1

AutoUpdate
描述： 自动更新
类型： int
说明： 自动更新
示例： #name.AutoUpdate=1

YGridColor
功能： Y 轴网格的颜色
语法： #BarChart.YGridColor=NVALUE
说明： NVALUE 为力控颜色索引号
示例： #BarChart.YGridColor =0;// 设置棒图网格颜色为红色

YGrid
功能： 显示 Y 轴网格
语法： #BarChart.YGrid=NVALUE
说明： NVALUE 为整型
示例： #BarChart.YGrid=1

DecimalNum
功能： 棒图标签值的小数位数
语法： #BarChart.DecimalNum=NVALUE
说明： NVALUE 为整型
示例： #BarChart.DecimalNum =2

BarLabelColor
功能： 棒图标签的颜色
语法： #BarChart.BarLableColor=NVALUE
说明： NVALUE 为力控颜色索引号
示例： #BarChart.BarLableColor =0;// 设置棒图标签的颜色为红色

BarLabel
功能： 棒图标签
语法： #BarChart.BarLable=NVALUE
说明： NVALUE 为整型
示例： #BarChart.BarLable=1

Step
功能： Y 轴刻度的增量，设置了自定义刻度时才有效
语法： #BarChart.Step=NVALUE
说明： NVALUE 为实数型
示例： #BarChart.Step=10.0

Min
功能： Y 轴刻度的最小值，设置了自定义刻度时才有效
语法： #BarChart.Min=NVALUE
说明： NVALUE 为实数型
示例： #BarChart.Min=0.0

Max
功能： Y 轴刻度的最大值，设置了自定义刻度时才有效
语法： #BarChart.Man=NVALUE
说明： NVALUE 为实数型
示例： #BarChart.Man=100.0