beginInsert (RichTextItem - Java)

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

Defined in



public void beginInsert(Base element)
    throws NotesException
public void beginInsert(Base element, boolean after)
    throws NotesException


Base element

EmbeddedObject, RichTextDocLink, RichTextNavigator, RichTextRange, RichTextSection, or RichTextTable. The element. A RichTextNavigator element means the element at the current position of the navigator. Other elements mean the specified element.

boolean after
  • true to put the insertion position at the end of the element
  • false (default) to put 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.