文書内の指定された名前を持つ最初のアイテムを返します。

定義位置

Document

構文

public Item getFirstItem(String name)
   throws NotesException

パラメータ

String name

検索したいアイテムの名前です。

アイテム

name を持つ最初のアイテムを返します。name を持つアイテムが文書に含まれていない場合は、null を返します。

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

フィールドの値が計算されて表示される場合、その値はアイテムとしては格納されず、Document オブジェクトからはアクセスできません。場合によってはフィールド値に別の方法でアクセスできます。たとえば、式 @Created を使用して計算して表示される [DateComposed] フィールドが文書に含まれている場合は、getCreated を使用します。

このメソッドを使用してリッチテキストアイテムを取得する

リッチテキストアイテムを取得するには、getFirstItem からの戻り値を明示的に RichTextItem にキャストします。

Document doc;
//...set value of doc...
RichTextItem rtitem = (RichTextItem)doc.getFirstItem("Body");

LotusScript NotesDocument クラスの GetFirstItem メソッド

例
関連項目

Java クラス内でアイテムとその値を取得する

用語集