指定された名前のすべてのアイテムを 1 つの新規アイテムに置き換えます。新規アイテムには指定された値が割り当てられます。文書に指定された名前のアイテムがないとき、このメソッドはアイテムを新規に作成して文書に追加します。

定義位置NotesDocument
構文Set notesItem = notesDocument.ReplaceItemValue( itemName$, value )
パラメータitemName$

String 型。置換したいアイテムの名前です。

新規アイテムの値です。新規アイテムのデータ型は値のデータ型に応じて変わります。置換前のアイテムのデータ型と一致する必要はありません。

メモ ReplaceItemValue メソッドは NotesDateTime オブジェクトを入力として直接使用します。

	value のデータ型	作成される Lotus Notes アイテム
	String 型	value を含むテキストアイテム
	String 型の配列	value の各要素を含むテキストアイテム
	Long 型、Integer 型、Double 型、Single 型、または Currency 型	value を含む数値アイテム
	Long 型、Integer 型、Double 型、Single 型、または Currency 型の配列	value の各要素を含む数値アイテム
	DATE 形式の Variant 型、NotesDateTime 型、または NotesDateRange 型	value を含む日時アイテム
	DATE 形式の Variant 型の配列、NotesDateTime 型の配列、または NotesDateRange 型の配列	value の各要素を含む日時アイテム
	NotesItem 型	データ型と値が NotesItem と一致するアイテム

必要に応じて、データ型の変換が行われます。たとえば、浮動小数点数値アイテムは倍精度であるため、Single 型の値は Double 型に変換されてから保存されます。

NotesItem。新規アイテムを返します。指定した名前のアイテムはすべてこのアイテムによって置き換えられます。新規アイテムは新しい value を持ちます。新しい値のデータ型は以前の値のデータ型と違う場合があります。

「拡張クラス」構文NotesDocument「拡張クラス」構文を使ってもアイテムの値を変更できます。NotesDocument「拡張クラス」構文を使うと ReplaceItemValue を使う必要がありません。たとえば次のようなスクリプトがあるとします。

Dim item As NotesItem
Set item = doc.ReplaceItemValue _
( "Subject", "Update on stock options" )
Call doc.Save( False, True )

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

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

式言語の @SetDocField 関数

式言語の FIELD キーワード

例
関連項目

LotusScript のクラスでアイテムを作成して値を代入する

用語集