Pens 集合的 Add 方法

Pens 集合的成员。

创建一支笔并将其添加到 Pens 集合中。返回值为新笔。一个趋势图最多可容纳 100 支笔。

需要除 DatalogModelName 外的所有参数，但是，描述和工程单位参数可以是空的字符串。

语法

Pens.Add(Name, Desc, EngUnits, Min, Max,

[

DatalogModelName

], [

Historian

], [

LoadModelData

], [

LogScale

])

As Pen

其中

Pen

- 是容纳新笔的一个 Pen 对象。

Pens

- 是 Pens 集合，新笔将被添加到其中。

Name

- 是字符串型参数，指定新笔的标签名称。标签必须唯一。

Descr

- 是字符串型参数，指定笔的描述。描述可显示在图表左侧或底部的线条图例中。

EngUnits

- 是字符串型参数，指定笔的工程单位。工程单位可显示在图表左侧或底部的线条图例中。

Min

- 是单精度型参数，指定一个单精度浮点数。图表底部所表示的值。根据 MinMaxOption 和 ScalingOption 属性，笔的 Min 和 Max 参数可能无效。

Max

- 是单精度型参数，指定一个单精度浮点数。图表顶部所表示的值。

DatalogModelName

- 是要添加的数据记录模型的名称。可选。

Historian

- 是布尔型参数，用于指定被添加的笔是 (True) 或不是 (False) 一支 FactoryTalk Historian 笔。可选。

LoadModelData

- 是布尔型参数，表示是否应在将笔添加到趋势时加载笔历史数据。如果此参数为 True，则将下载历史数据。如果此参数为 False，则不会下载历史数据。如果未指定此参数，则将下载历史数据。可选。

LogScale

- 是布尔型参数，指示笔是否采用以 10 为底的对数刻度进行显示。可选。

备注

如果在调用此方法时将 LoadModelData 参数设置为 False，趋势将不会显示笔历史数据。在此情况下，如果要载入历史数据，请执行以下操作之一：