Table Styles Dialog

  • 2 minutes to read

The Table Styles (Create New Style from Formatting or Modify Style) dialog enables end-users to create a new table style or modify an existing one. The style settings can be applied to the whole table or a specific element: header or total row, first column, last column, banded rows or columns (odd and even); top right, top left, bottom right or bottom left cell.

DXRichEdit_Dialogs_TableStyles

End-users can invoke this dialog using the Table Style gallery of the Table Tools | Design ribbon tab. Right-click the target table style in the gallery and select New Style... or Modify Style...

DXRichEdit_Dialogs_TableStyles_Invoke

...or select the corresponding gallery menu item. Refer to the Lesson 1 - Create a Simple Rich Text Editor topic for details on how to provide a ribbon UI for the RichEditControl. Executing the ShowTableStyleFormCommand command invokes this dialog as well.

DXRichEdit_Dialogs_TableStyle_InvokeFromGallery

End-users can select the style to be modified from the Current Style: list. The Name box allows you to change the name of the current table style.

The target style can be based on any other available style. Select the base style from the Style based on: list.

In the dialog's Formatting section, end-users can change table cells' appearance (borders visibility, color and thickness) and content (font, size, style and alignment). Select the particular element to which new style options should be applied from the Apply formatting to: list.

DXRichEdit_Dialogs_TableStyles_ApplyFormattingTo

Click the Format button and select the desired item to invoke the Font or Paragraph and Tabs dialog to specify more advanced font, paragraph or tabs settings for the target style.

When a table style is applied to a particular table, not all style elements are applied. End-users can use the Table Style Options group in the ribbon UI to determine which table elements are formatted with the applied style.

TIP

Call the TableStyleCollection.Add method to create the TableStyle instance and specify its necessary properties in code. Refer to the Tables topic for an example.

See Also