指定された名前のすべてのアイテムを 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

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

新規アイテムを文書に保存するには、ReplaceItemValue を呼び出した後に Save メソッドを呼び出す必要があります。

新規アイテムの IsSummary プロパティはデフォルトで True が設定されます。つまり、アイテムの値はビューかフォルダで表示できます。

テキストアイテムに変更する場合を除き、リッチテキストアイテム (または MIME エンティティ) の値を置き換える目的でこのメソッドを使用しないでください。リッチテキストアイテムの内容を置き換える場合には、NotesDocument.RemoveItem または NotesRichTextItem.Remove を使用して古いアイテムを削除し、NotesDocument.CreateRichTextItem を使用して同じ名前で新しいアイテムを作成し、NotesRichTextItem.AppendText およびその他のメソッドを使用して新しい内容を追加します。

「拡張クラス」構文

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 )

1 回限りのスクリプトでこの構文が使用できる場合、次の理由により ReplaceItemValue を優先的に使用します。

• 作成したコードを他の人が読む場合、拡張構文は NotesDocument のメソッドまたはプロパティと混同されやすい
• 将来のリリースでアイテム名が競合するメソッドまたはプロパティが追加された場合に、作成したコードが正しく機能しなくなる場合がある
• ReplaceItemValue ではアイテム名の大文字小文字が保持されるが、拡張クラス構文でフィールドを作成するとアイテム名がすべて大文字になる
• ReplaceItemValue のほうがやや効率的

Java Document クラスの replaceItemValue メソッド

式言語の @SetField 関数

式言語の @SetDocField 関数

式言語の FIELD キーワード

例
関連項目

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

用語集