AddPageBreak (NotesRichTextItem - LotusScript®)

Inserts a hard page break in a rich text item.

Note: This method is new with Release 5.

Defined in



Call notesRichTextItem .AddPageBreak( [notesRichTextParagraphStyle] )



Optional. NotesRichTextParagraphStyle. Starts the new page with the specified paragraph style.


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

This method may be called with or without the RichTextParagraphStyle object as a parameter. If the optional parameter is supplied, the new page begins with the paragraph style.

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.