FindNthElement (NotesRichTextNavigator - LotusScript®)

Moves the current position to the element at a specified position within elements of the same type.

Defined in

NotesRichTextNavigator

Syntax

flag = notesRichTextNavigator .FindNthElement( 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)

occurrence&

Long. The position of the element within elements of the same type in the rich text item. Must be a positive integer. 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 the specified position does not exist.

You can use this method as a basis for future navigation, for example, with FindNextElement if occurrence is explicitly specified.

Example