AddNewLine (NotesRichTextItem - LotusScript®)

Inserts one or more new lines (carriage returns) in a rich text item.

Defined in



Call notesRichTextItem .AddNewLine( n% [, forceParagraph ] )



Note: In COM this parameter is optional and defaults to 1.

Integer. The number of new lines to append.


Boolean. Optional. If True, forces the new line to be a paragraph separator. If False, the new line is added, but does not force a new paragragh. True by default.


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.