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

定義位置
NotesDocument 型

構文
valueArray = notesDocument.GetItemValue( itemName$ )

パラメータ
itemName$

String 型。アイテムの名前です。

指定された名前に含まれる値を返します。値のデータ型はアイテムのデータ型に応じて変わります。

	Notes アイテムの種類	戻り値の種類
	リッチテキスト	String 型の配列。アイテムのテキスト。属性のないテキストに変換されます。
	文字列または文字列のリスト (Names、Authors、Readers アイテムを含みます)	String 型の配列
	数値または数値リスト	Double 型の配列
	日時値または日時値の範囲	DATE 形式の Variant 型の配列

GetItemValue が配列を返すとき、配列の各要素はアイテムの値に対応しています。アイテムの値の数が 1 つのとき、配列の要素は 1 つだけです。

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

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

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

t = lastDoc.GetItemValue( "Topic" )
t = lastDoc.Topic

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

mailMemo.Subject = "Update on stock options"
Call mailMemo.Save( False, True )

クロスリファレンス
Java Document クラスの getItemValue メソッド

式言語の @Count 関数

式言語の @GetDocField 関数

式言語の @GetField 関数

式言語の @GetProfileField 関数

例
関連項目

LotusScript のクラスでアイテムとその値を取得する
LotusScript のクラスでリッチテキストアイテムのテキスト表現を取得する