AppendTable (NotesRichTextItem - LotusScript®)

Inserts a table in a rich text item. The table text takes the current style of the item.

Note: This method is new with Release 6.

Defined in



Call notesRichTextItem .AppendTable( rows% , columns% [ , labels] [ , leftMargin&] [ , rtpsStyleArray] )



Integer. Number of rows in the table.


Integer. Number of columns in the table.


Array of type String. Optional. Text of labels for a tabbed table. The number of array elements must equal the number of rows. Omitting this parameter appends a basic table. Including this parameter appends a tabbed table.


Long. Optional. Left margin of the table in twips. Defaults to 1440. The following constants are available:

  • RULER_ONE_INCH (1440)


Array of type NotesRichTextParagraphStyle. Optional. Creates a table with fixed-width columns and style attributes as specified. Omitting this parameter creates an auto-width table. The array must contain one element for each column in the table in sequence. Explicitly set the first line left margin and left margin, which control the start of text relative to the start of the column, and the right margin, which controls column width.


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

The NotesRichTextTable class represents a table.

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.