replaceItemValue (Java™)

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

定義位置

構文

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

パラメータ

String name

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

Object value

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

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

戻り値

Item

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

使用法

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

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

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

クロスリファレンス

LotusScript® NotesDocument クラスの ReplaceItemValue メソッド

式言語の @SetField 関数

式言語の @SetDocField 関数

式言語の FIELD キーワード

例