JAVA/CORBA クラス

getFirstItem メソッド
例

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

定義が行われるクラスDocument
構文public Item getFirstItem(String name)
throws NotesException
パラメータString name


戻り値Item
使用法文書の複数アイテムが同じ名前の場合、プログラムでのアクセスは最初のアイテムに制限されます。残りのアイテムには不正データが生じます。この対策としては、最初のアイテムを取得し、これを処理して削除し、再び最初のアイテム、つまり 2 つ目のアイテムを取得します。このようにして、同じ名前のアイテムをすべて処理します。文書を保存しないと、アイテムは実際に削除されません。ただし、同じ名前での複数アイテムの作成は避けてください。
フィールドの値が計算されて表示される場合、その値はアイテムとしては格納されず、Document オブジェクトからはアクセスできません。場合によってはフィールド値に別の方法でアクセスできます。たとえば、式 @Created を使用して計算して表示される [DateComposed] フィールドが文書に含まれている場合は、getCreated を使用します。

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


クロスリファレンスLotusScript NotesDocument クラスの GetFirstItem メソッド
例
関連項目