LOTUSSCRIPT /COM/OLE のクラス

GetItemValue メソッド
例

文書内の指定された名前のアイテムの値を返します。

定義位置NotesDocument
構文valueArray = notesDocument.GetItemValue( itemName$ )
パラメータitemName$


戻り値value
使用法複数のアイテムが同じ名前を持つ場合は、このメソッドは最初のアイテムの値を返します。
テキスト、数値、日時アイテムの場合、アイテムの値が 1 つのときでも、GetItemValue は常に配列を返します。アイテムの値が 1 つだけであると分かっているときは、配列の第 1 番目の要素にアクセスします。配列の第 1 番目の要素のインデックスは 0 です。アイテムに複数の値があると分かっているが、その個数については分からない場合には、Forall ステートメントを使って配列要素に繰り返しアクセスします。

NotesDateTime、NotesDateRange オブジェクトの配列として日時値を取得するには、GetItemValueDateTimeArray を参照してください。

「拡張クラス」構文GetItemValue を使わずに、フィールドの内容に直接アクセスできます。次の 2 つのステートメントの意味は同じです。


この構文を使うと、他の NotesDocument プロパティにアクセスしたり変更するのと同じ方法で、アイテムにアクセスしたり変更できます。戻り値はほかの NotesDocument プロパティの場合と同じです。つまり、文字、数値、日時のアイテムの場合は値の配列が返され、リッチテキストフィールドの場合は文字列が返されます。

この構文を使うと、次のようにアイテムの値を設定することもできます。


この構文でアイテムの値を設定する方法について詳しくは、AppendItemValue メソッドと ReplaceItemValue メソッドを参照してください。

クロスリファレンスJava Document クラスの getItemValue メソッド
式言語の @Count 関数

式言語の @GetDocField 関数

式言語の @GetField 関数

式言語の @GetProfileField 関数

例
関連項目