FindNextElement (NotesRichTextNavigator - LotusScript®)

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

flag = notesRichTextNavigator .FindNextElement( [ type% ] [, occurrence& ] )

Parameters

type%

Constant. The type of element:

  • RTELEM_TYPE_DOCLINK (5)
  • RTELEM_TYPE_FILEATTACHMENT (8)
  • RTELEM_TYPE_OLE (9)
  • RTELEM_TYPE_SECTION (6)
  • RTELEM_TYPE_TABLE (1)
  • RTELEM_TYPE_TABLECELL (7)
  • RTELEM_TYPE_TEXTPARAGRAPH (4)
  • RTELEM_TYPE_TEXTRUN (3)

Defaults to the type last specified by a find method.

occurrence&

Long. 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

flag

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