# AddTag

マニュアル > コントロールリファレンス > 全コントロール共通 > 共通メソッド > # AddTag |

| タグの登録を行います。 構文 AddTag( TagName [,Active = TRUE] ) パラメータ
TagName
| 型： | 文字
| タグ名。配列として複数のタグ名を指定することが可能。
Active
| 型： | ブール
| タグから値を取得したい時はTRUE を、値を取得しない場合はFALSE を指定してください。例えば、WriteVal による書き込みしか行わない場合にFALSE を設定すると、値を取得するため負荷が軽減されます。又、FALSE 時にはOnTagValueChanged イベントは発生しません。
戻り値
| 型： | ブール
| FALSE - 失敗。TRUE - 成功。
解説
オブジェクト内のスクリプトからアクセスするタグの宣言（登録)を行います。通常は、OnInitialize イベントでタグを登録します。AddTag の呼び出し後、そのタグに対して下記のメソッドが利用できるようになります。 GetVal/ ReadVal/ WriteVal/ ReadRefresh/ WriteRefresh/ ReadRequestRefresh/ WriteRequestRefresh 又、登録したタグの値が化したときに OnTagValueChanged イベントが呼び出されるようになります。 各メソッドは、AddTag で登録したオブジェクト内で効です。例えば、タグを登録したオブジェクトのスクリプトから GetVal を呼び出す場合は、単純にthis.GetVal とします。あるいは、フォームにタグを登録して、各コントロールオブジェクトからメソッドを呼び出す場合には、parent.GetValとして呼び出すことができます。
例
タグを登録したオブジェクトのスクリプト内でGetVal を呼び出す場合
    event OnInitialize()
    {
     this.AddTag("$D0");
    }
    event OnMouseUp(button)
    {
     this.Text = this.GetVal("$D0");
    }
複数のタグをまとめて扱いたい時は、複数のタグ名を文字配列として指定することもできます。 どれか１つでもAddTag に失敗した場合、返値はFALSE になります。途中で、AddTag に失敗したタグがあった場合でも、AddTag は最後のタグまで行われます。 複数のタグをまとめて扱う場合
    var vTags = c("$D0","$D1","$D2","$D3","$D4");
    event OnInitialize()
    {
     this.AddTag(vTags);
    }
    event OnMouseUp(button)
    {
     var a = this.GetVal(vTags);
     this.Text = ::Math.Ave(a);
    }
サポート対象
| ○ | スクリプトアクション
サーバのスクリプトVer2アクションで使用可能
| ○ |
ブラウザスクリプト
ブラウザのスクリプトにて使用可能
| × |
演算式構文
演算式構文（バインド書式など）にて使用可能
参照 AddTag DelTag ClearAllTag GetVal ReadVal WriteVal ReadRefresh WriteRefresh ReadRequest ReadRequestRefresh WriteRequest WriteRequestRefresh