findNextElement (RichTextNavigator - Java™)

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

Defined in

RichTextNavigator

Syntax

public boolean findNextElement()
    throws NotesException
public boolean findNextElement(int type)
    throws NotesException
public boolean findNextElement(int type, int occurrence)
    throws NotesException

Parameters

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

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.

Example