HTSetPenName() 函数

HTSetPenName() 函数将一个不同的标记指定给趋势的某支笔。

类别

历史

语法

HTSetPenName(Hist_Tag,PenNum,Tagname);

参数

Hist_Tag

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

PenNum

代表趋势的笔号（从 1 到 8）的整型标记或值。

Tagname

指定给笔的新标记的名称。

附注

此 QuickScript 函数是在运行时从分布式历史供应器添加标记的唯一方法。

最多可以为笔名称中的引用输入 49 个字符。

试图取消指定趋势笔时，可能会看到以下错误消息：

VIEW /UpdateData:Invalid DBS.TAGNAME handle – 0

如果试图取消指定先前按照 histprovider.tag_name 的形式指定给某个远程标记的笔，则会发生此错误。要解决此错误，请创建一个选择了记录数据选项的本地标记。然后使用以下脚本来取消指定这支笔：

HTSetPenName( "HistTrend", 1, "localtag" );

{assigns the pen to a locally logged tag---localtag}

HistTrend.Pen1=None;

{unassigns the pen}

其中，None 是 TagID 类型标记。

示例

以下语句将 OutletPressure 标记指定给 Trend1 的 3 号笔。

HTSetPenName("Trend1",3,"OutletPressure");

以下语句将 HistPrv1.Tag1 标记指定给 Trend1 的 TrendPen4。

HTSetPenName("Trend1",TrendPen4,"HistPrv1.Tag1");

另请参阅

HTSelectTag()