NotesDocument クラスには、文書のアイテムにアクセスするためのプロパティとメソッドが多数存在します。アイテムの名前が分からない場合や、文書内のすべてのアイテムに順番にアクセスしたい場合は、NotesItem オブジェクトの配列である Items プロパティを使用します。配列の各要素にアクセスするには、NotesItem のプロパティとメソッドを使用してオブジェクトを調べたり操作したりします。

名前が分かっているアイテムにアクセスするには、NotesDocument の GetFirstItem メソッドを使用します。

アイテムの値を取得する方法はいくつかあります。次に示す最初の 2 つの方法では、最初にアイテムオブジェクトにアクセスする必要はありません。

• アイテムを含む NotesDocument オブジェクトにアクセスした後で、文書のプロパティを指定するのと同様の方法で、アイテム名を指定できます。たとえば、doc が文書オブジェクトの名前で、Subject が文書のアイテムである場合、doc.Subject はこのアイテムの値を示します。
• NotesDocument の GetItemValue メソッドを使用します。
• アイテムにアクセスしてそのアイテムの Values プロパティを調べます。

文書中で「Received」という名前のアイテムのテキストの値を取得するには、GetReceivedItemText を使用します。

1 つの文書内で複数のアイテムが同じ名前を持つ場合は、プログラムによるアクセスは最初のアイテムのみに限定されます。残りのアイテムは、無効なデータとなります。回避策としては、最初のアイテムを取得して処理し、削除してから、再度、最初のアイテム (元は 2 番目だったアイテム) を取得するといった具合に、特定の名前のすべてのアイテムの処理と削除を終えるまで繰り返します。その文書を保存しなければ、アイテムは実際に削除されません。しかし、推奨される方法は、同じ名前を持つ複数のアイテムの作成を避けることです。

例
関連項目

LotusScript のクラスでアイテムにアクセスする

用語集