appendText (RichTextItem - Java)

Appends text to a rich text item. The text is rendered in the current style of the item.

Defined in



public void appendText(String text)
    throws NotesException


String text

The text to append.


By default the insertion occurs at the end of the item. You can change the insertion point with beginInsert and endInsert.

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.

New lines (carriage returns) inserted in appended text do not cause new paragraphs. To create a new paragraph, use addNewLine. Paragraphs are restricted to approximately 35K of text and are automatically divided if this limit is exceeded.