Skip to main content

Table Properties Dialog

  • 3 minutes to read

Overview

The Table Properties dialog allows users to change settings of an entire table and its elements: rows, columns, and cells.

Click Properties or Cell Size dialog box launcher on the Table Tools | Layout ribbon tab to invoke this dialog. Refer to the Create a Simple Rich Text Editor topic for information on how to add the ribbon UI to the RichEditControl.

DXRichEdit_ShowTablePropertiesDialog_RibbonPropertiesButton

The Table Properties dialog is also available from the context menu.

DXRichEdit_ShowTablePropertiesDialog_ContextMenu

The dialog consists of the following tabs:

Table

Table tab options allow users to set preferred table width, alignment (table position relative to page margins), text wrapping and direction.

DXRichEdit_TableProperties_Table

The following API allows you to specify Table options in code:

Member Description
Table.SetPreferredWidth Specifies the table width.
Table.TableAlignment Specifies the table alignment. This property is ignored if the TextWrappingType is set to Around.
Table.TextWrappingType Specifies the text wrapping around the table.

The Options… button invokes the Table Options dialog used to specify cell margins, spacing and whether to resize cells to fit content.

DXRichEdit_TableOptionsDialog

Member Description
TableCell.TopPadding Specifies the cell’s top margin.
TableCell.RightPadding Specifies the cell’s right margin.
TableCell.BottomPadding Specifies the cell’s bottom margin.
TableCell.LeftPadding Specifies the cell’s left margin.
Table.TableCellSpacing Specifies the spacing between cells.

The Borders and Shading… button invokes the Borders and Shading dialog. Set the Text Wrapping option to Around to enable the Positioning button (used to invoke the Table Positioning dialog).

Row

The Row tab allows users to set the row height.

DXRichEdit_TableProperties_Row

Use the following API to set row options in code:

API Description
Table.ForEachCell() Allows you to specify width for each table cell.
TableRow.HeightType Gets or sets the height type.
TableRow.Height Defines row height.
TableRow.RepeatAsHeaderRow Specifies whether to repeat a header row at the top of each page.
TableRow.BreakAcrossPages Specifies whether the row can be split when the table expands to another page.

Column

On the Column tab, users can set tick the Preferred width box to specify column width.

DXRichEdit_TableProperties_Column

Use the following API to set column width in code:

API Description
Table.ForEachCell() Allows you to specify width for each table cell.
TableCell.PreferredWidthType Gets or sets the width type.
TableCell.PreferredWidth Defines cell width.

Cell

Cell tab options allow users to set the preferred table cell width and select the vertical alignment of cell content

DXRichEdit_TableProperties_Cell

The API from the table below allows you to specify the Cell options in code:

Member Description
TableCell.PreferredWidthType Gets or sets the width type.
TableCell.PreferredWidth Defines the cell width.
TableCell.VerticalAlignment Specifies cell content’s alignment.

The Options… button invokes the Cell Options dialog. Use this dialog to to change cell margins (the space between cell borders and cell content) and specify whether to wrap the cell content.

DXRichEdit_CellOptionsDialog

Member Description
TableCell.TopPadding Specifies the cell’s top margin.
TableCell.RightPadding Specifies the cell’s right margin.
TableCell.BottomPadding Specifies the cell’s bottom margin.
TableCell.LeftPadding Specifies the cell’s left margin.
Table.TableCellSpacing Specifies the spacing between cells.
TableCell.WordWrap gets os sets whether to wrap cell content.