appendTable (RichTextItem - Java)

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

Defined in



public void appendTable(int rows, int columns)
    throws NotesException
public void appendTable(int rows, int columns, java.util.Vector labels)
    throws NotesException
public void appendTable(int rows, int columns, java.util.Vector labels, int leftmargin, java.util.Vector rtpstyles)
    throws NotesException


A default is taken if the signature does not include the parameter or the parameter is specified as null.

int rows

Number of rows in the table.

int columns

Number of columns in the table.

java.util.Vector labels

Elements are of type String. Text of labels for a tabbed table. The number of elements must equal the number of rows. Specifying this parameter appends a tabbed table. The default is a basic table.

int leftmargin

Left margin of the table in twips. The following constants are available:

  • RichTextParagraphStyle.RULER_ONE_CENTIMETER
  • RichTextParagraphStyle.RULER_ONE_INCH (default)
java.util.Vector rtpstyles

Elements are of type RichTextParagraphStyle. Creates a table with fixed-width columns and style attributes as specified. The default is an auto-width table. The vector 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 RichTextTable 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.