addNewLine (RichTextItem - Java)

Appends one or more new lines (carriage returns) to a rich text item.

Defined in



public void addNewLine()
    throws NotesException
public void addNewLine(int count)
    throws NotesException
public void addNewLine(int count, boolean newparagraph)
    throws NotesException


int count

The number of new lines to append.

boolean newparagraph

If true (default), forces the new line to be a paragraph separator. If false, the new line is added, but does not force a new paragragh.


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.