BeginInsert (NotesRichTextItem - LotusScript®)

Changes the insertion position from the end of the rich text item to the beginning or end of a specified element.

Note: This method is new with Release 6.

Defined in



Call notesRichTextItem .BeginInsert( element , [ after ] )



NotesEmbeddedObject, NotesRichTextDocLink, NotesRichTextNavigator, NotesRichTextRange, NotesRichTextSection, or NotesRichTextTable. The element. A NotesRichTextNavigator element means the element at the current position of the navigator. Other elements mean the specified element.


Boolean. Optional.

  • True puts the insertion position at the end of the element.
  • False (default) puts the insertion position at the beginning of the element.


In an open document in edit mode (the NotesDocument via NotesUIDocument.Document), changes made to rich text will not appear on screen immediately as they would with fields of other types. There is no method to cause this update to occur. You must close and reopen the document to see changes.