Returns the first item of a specified name in a document.

Defined in

Document

Syntax

public Item getFirstItem(String name)
   throws NotesException

Parameters

String name

The name of the item you want to find.

Item

The first item with name. Returns null if the document does not contain an item with name.

A document may contain more than one item of the same name. To access other than the first item, use the Items property.

If the value of a field is computed for display, the value is not stored as an item and is inaccessible from a Document object. In some cases, you can access the field value another way. For example, if a document has a DateComposed field computed for display with the formula @Created, use getCreated.

Using this method to get rich text items

To get a rich text item, explicitly cast the return value from getFirstItem to RichTextItem.

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

GetFirstItem method in LotusScript NotesDocument class

Example
See Also

Getting an item and its values in Java classes