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

定義位置

Document

構文

public Item replaceItemValue(String name, Object value)
   throws NotesException

パラメータ

String name

String 型。置き換えるアイテムの名前です。

新規アイテムの値です。アイテムのデータ型は、value のデータ型によって決まり、元のアイテムのデータ型と同一である必要はありません。

	value のデータ型	対応するアイテム
	String 型	Text
	Integer 型	数値
	Double 型	数値
	DateTime 型	日付/時刻アイテム
	String、Integer、Double、または DateTime 型の要素を持つ java.util.Vector 型	複数の値を持つ文字列、数値、または日付/時刻アイテム
	アイテム	アイテムと同じデータ型

アイテム

同じ名前を持つ元のアイテムをすべて置き換える新規アイテムです。

変更を保存するには、replaceItemValue を呼び出した後に save を呼び出す必要があります。

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

リッチテキストアイテム (または MIME エンティティ) の値を置き換える場合は、このメソッドを使用しないでください。このメソッドを使用すると、テキストアイテムに置き換わってしまいます。リッチテキストアイテムの内容を置き換えるには、Document.removeItem または RichTextItem.remove を使用して古いアイテムを削除し、Document.createRichTextItem を使用して同じ名前のアイテムを作成してから、RichTextItem.appendText やその他のメソッドを使用して新しい内容を追加します。

クロスリファレンス

LotusScript NotesDocument クラスの ReplaceItemValue メソッド

式言語の @SetField 関数

式言語の @SetDocField 関数

式言語の FIELD キーワード

例
関連項目

Java クラス内でアイテムを作成して値を割り当てる

用語集