​.Pen1-8 点域

.Pen1-8 点域将记录的标记指定给某个历史趋势笔。

类别

历史

用法

HistTrendTag{.Pen1 | .Pen2 | .Pen3 | .Pen4 | .Pen5 | .Pen6 | .Pen7 | .Pen8};

参数

HistTrendTag

指定了趋势的名称的“历史趋势”标记。

附注

使用 .Pen1-8 点域采用以下格式将标记指定给趋势笔：

HistTrend.PenX = Tag_Name.TagID

其中 X 是 1 到 8 之间的整数。

建议尽量使用 HTSetPenName() 与 HTGetPenName() 函数。

备注：只有本地标记可以指定给 .PenX 点域。无法使用 provider.tag 表示法。provider.tag 仅可以用于 HTSetPenName() 函数。
在了解这些点域的工作原理时，一个很好的参考就是放置到屏幕上并进行了分解的历史趋势向导。

数据类型

TagID（可读写）。

有效值

点域数据类型是 TagID 类型。这就意味着，只有标记的句柄可以指定给 .Pen1-8 点域。您无法将标记的名称直接指定给 .Pen1-8 点域。您必须使用以下语法将与标记关联的 .TagID 点域关联到 Pen1-8 点域：

HistTrendTag.Pen1=LoggedTag.TagID;

一般而言，TagID 类型标记仅可赋给另一个 TagID 标记。它无法与任何其它标记类型配合使用，除非其它标记中添加了 .TagID 点域扩展名。

尽管 .Pen1-8 点域被视为可读写，但无法直接在屏幕上显示它们的值。

示例

下例将新标记指定给与“历史趋势”标记关联的历史趋势的 .Pen5 点域。要将所记录的标记指定给 .Pen5 点域，必须将 .TagID 点域附加到所记录的标记的名称中。

HistTrendTag.Pen5=PumpPress.TagID;

从上例开始，可以显示指定给 HistTrendTag.Pen5 的标记的名称。对于操作员来说，创建一个图例来显示指定给每个趋势笔的标记，这是非常有用的信息。

您无法在“消息显示”链接中显示指定给 HistTrendTag.Pen5 的标记。.Pen5 点域的实际值是一个整数，表示 WindowViewer 中的内存位置，这对于显示目的而言毫无意义。您需要创建一个名称为 Pen05 的 TagID 型标记。将以下语句放到上例中的语句之下：

Pen05=HistTrendTag.Pen5;

在第一个示例中，PumpPress 标记指定给 HistTrendTag 的 5 号笔。在本例中，Pen05 被指定 HistTrendTag 的 Pen5 的值，而 HistTrendTag 则是 PumpPress 标记的 TagID。

.Pen1-8 这些点域是一些指针，它们指向与选择要在趋势中显示的笔关联的标记。.Pen1-8 这些点域是一种特殊的数据类型，即 .TagID。执行指定之后，您可以使用 TagID 标记的 .Name 点域显示标记的名称。