CreateLabel メソッド(ActiveX/CAO)

アタッチ ラベルまたは独立ラベルを作成します。

構文と要素

VBA/VB.NET

RetVal = object.CreateLabel(Arg1, KeyValues, LabelTemplate [, DisplayValues])

object

タイプ: LinkTemplate

このメソッドが適用されるオブジェクト

Arg1

タイプ: オブジェクト ID の場合は長整数型、それ以外はバリアント型(倍精度実数の 3 要素配列); 入力のみ

ラベルをアタッチするグラフィカル オブジェクト、または独立ラベルの挿入位置

KeyValues

タイプ: KeyValues; 入力のみ

ラベルのキー フィールド値

LabelTemplate

タイプ: LabelTemplate、またはラベル テンプレートの命名に使用する文字列; 入力のみ

ラベル オブジェクトのラベル テンプレート

DisplayValues

タイプ: バリアント型(バリアント型の配列); 入力のみ; オプション

データベース テーブルで一致するキー フィールドが見つからない場合にラベルに表示する値

RetVal

タイプ: Label

新しいラベル オブジェクト

注意

作成するラベルに表示される値は、CreateLabel に渡す引数によって異なります。これらの値は、それ以降に Reload メソッドを呼び出した場合に変わることがあります。CreateLabel の動作は次のとおりです。

• 引数 DisplayValues を渡すと、その引数の値がラベルに表示されます。
• DisplayValues を指定しなかった場合、CAO はリンクされた行をデータベースから取得しようとします。正しく実行された場合は、行の値がラベルに表示されます。(接続されていない、キーの値に一致するものがデータベースにないなど)リンクされた行を取得できない場合は、エラーが発生します。
• 引数 DisplayValues を指定した場合でも、CreateLabel に続いて Reload メソッドの呼び出しを行うと、CAO は、リンクされた行をデータベースから取得しようとします。正しく実行された場合は、データベースの値がラベルに表示されます。リンクされた行を取得できない場合は、エラーが発生します。