AppendText (NotesRichTextItem - LotusScript®)

Inserts text in a rich text item. The text is rendered with the current style of the item (such as bold or italics).

Defined in



Call notesRichTextItem .AppendText( text$ )



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