JAVA/CORBA CLASSES


getNthDocument method
Example

Returns the document at a specified position in the top level of a view.

Defined in

View

Syntax

public Document getNthDocument(int n)
   throws NotesException

Parameters

int n


Return value

Document


Usage

This method accesses only top-level (main) documents in a view; response documents are excluded.

In a categorized view, this method returns only the first document in each main category (not each subcategory).

If you do not have reader access to the specified document, this method returns the next document to which you have reader access. If you increment n, the increment is relative to the actual value of n, not the document that was accessed. So you will access the same document repeatedly until that document actually is the nth document.

Using getNthDocument to iterate through a loop is strongly discouraged for performance reasons. See getNextDocument, getNextSibling, getPrevDocument, and getPrevSibling for the preferred loop structures.

Language cross-reference

GetNthDocument method in LotusScript NotesView class

Example
See Also