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" );

{ローカルでログ済みのタグ変数---localtagにペンを割り当てる}

HistTrend.Pen1=None;

{ペンの割り当てを解除する}

ここで、None はタグ変数 ID 型のタグ変数です。

例

以下のステートメントは、Trend1 のペン 3 に OutletPressure タグ変数を割り当てます。

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

以下のステートメントは、Trend1 の TrendPen4 に HistPrv1.Tag1 タグ変数を割り当てます。

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

参照項目

HTSelectTag()