JAVA/CORBA クラス


getFirstItem メソッド

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

定義が行われるクラス
Document

構文
public Item getFirstItem(String name)
throws NotesException

パラメータ
String name


戻り値
アイテム
使用法
文書の複数アイテムが同じ名前の場合、プログラムでのアクセスは最初のアイテムに制限されます。残りのアイテムには不正データが生じます。この対策としては、最初のアイテムを取得し、これを処理して削除し、再び最初のアイテム、つまり 2 つ目のアイテムを取得します。このようにして、同じ名前のアイテムをすべて処理します。文書を保存しないと、アイテムは実際に削除されません。ただし、同じ名前での複数アイテムの作成は避けてください。

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

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


クロスリファレンス
LotusScript NotesDocument クラスの GetFirstItem メソッド


関連項目