文書に新規のアイテムを作成してアイテムの値を設定します。
Set notesItem = notesDocument .AppendItemValue( itemName$ , value )
itemName$
String 型。新規アイテムの名前です。
value
新規アイテムの値です。新規アイテムのデータ型は、アイテムに設定する値のデータ型に応じて変わります。
| value のデータ型 |
作成される Notes アイテム |
|
|---|---|---|
| String |
value を含むテキストアイテム |
|
| String 型の配列 |
配列の各要素に対応する値を持つ多値テキストアイテム |
|
| Long 型、Integer 型、Double 型、Single 型、Currency 型 |
value を含む数値アイテム |
|
| Long 型、Integer 型、Double 型、Single 型、Currency 型の配列 |
配列の各要素に対応する値を持つ多値数値アイテム |
|
| DATE 形式の Variant 型、または NotesDateTime 型 |
value を含む日時アイテム |
|
| DATE 形式の Variant 型の配列、または NotesDateTime 型の配列 |
配列の各要素に対応する値を持つ多値日時アイテム |
|
| NotesItem |
データ型と値が NotesItem と一致するアイテム |
必要に応じて型変換が発生します。例えば、浮動小数点数値アイテムは倍精度であるため、Single 型の値は Double 型に変換されてから保存されます。
新規アイテムを文書に保存するには、AppendItemValue を呼び出した後に Save メソッドを呼び出す必要があります。
文書に itemName$ というアイテムがすでにあるとき、AppendItemValue は既存のアイテムを新規アイテムに置換しません。代わりにそれは、同じ名前のアイテムを作成し、指定された値を与えます。
新規アイテムの IsSummary プロパティはデフォルトで True が設定されます。つまり、アイテムの値はビューかフォルダで表示できます。
NotesDocument「拡張クラス」構文を使用しても文書にアイテムを作成できます。NotesDocument「拡張クラス」構文を使用すると、AppendItemValue を使用する必要がありません。例えば次のようなスクリプトがあるとします。
Dim item As NotesItem
Set item = doc.AppendItemValue _
( "Subject", "Update on stock options" )
Call doc.Save( False, True )次のスクリプトを実行すると上記のスクリプトと同じ結果になります。
doc.Subject = "Update on stock options"
Call doc.Save( False, True )この構文ではアイテム名を NotesDocument のプロパティとして使用することにより、NotesDocument を「拡張クラス」として扱えます。前の例では、「Subject」は NotesDocument クラスのプロパティであるかのように扱われています。実行結果は AppendItemValue の場合と同じです。ただし、動作に次の違いがあることに注意してください。
1 回限りのスクリプトでこの構文を使用する場合、
次の理由により appendItemValue を使用します。