findNextElement (NotesRichTextNavigator - JavaScript™)

Moves the current position to the next element of a specified type in a rich text item after the current position.

Defined in

NotesRichTextNavigator

Syntax

findNextElement() : boolean

findNextElement(type:int) : boolean

findNextElement(type:int, occurrence:int) : boolean

Parameter	Description
int type	RichTextItem.RTELEM_TYPE_DOCLINK RichTextItem.RTELEM_TYPE_FILEATTACHMENT RichTextItem.RTELEM_TYPE_OLE RichTextItem.RTELEM_TYPE_SECTION RichTextItem.RTELEM_TYPE_TABLE RichTextItem.RTELEM_TYPE_TABLECELL RichTextItem.RTELEM_TYPE_TEXTPARAGRAPH RichTextItem.RTELEM_TYPE_TEXTRUN Defaults to the type last specified by a find method.
int occurrence	The position of the element, within elements of the specified type, relative to the current position; 1 means the next element, 2 means the element after the next element, and so on. Must be a positive integer; you cannot use this method to find preceding elements. Defaults to 1.

Return value	Description
boolean	true if the element exists and the current pointer is reset false if the element does not exist and the current pointer is not reset

Usage

This method returns false if a current position does not exist, for example, if you use this method without first calling findFirstElement or findNthElement.