Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]Welcome to DevExpress .NET Documentation
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Collapse]Rich Text Editor
   [Expand]Product Information
    Product Class Structure
    Supported Formats
   [Expand]Getting Started
   [Expand]RichEditControl Document
   [Expand]Fields
    Text Formatting
    Import and Export
   [Expand]Page Layout
    Printing
    AutoCorrect
    Mail Merge
    Restrictions and Protection
    Syntax Highlighting
    Traversing the Document
   [Collapse]Visual Elements
    [Expand]Rich Edit Control
    [Expand]Command UI
     Pop-up Menus
    [Collapse]Dialogs
      Paste Special Dialog
      Font Dialog
      Paragraph and Tabs Dialogs
      Bullets and Numbering Dialog
      Find and Replace Panel
      Symbol Dialog
      Bookmark Dialog
      Edit Hyperlink Dialog
      Page Setup Dialog
      Columns Dialog
      Line Numbers Dialog
      Document Protection Dialogs
      Editing Permissions Dialog
      Table Layout Dialogs
      Table Styles Dialog
      Table Properties Dialogs
      Borders and Shading Dialog
      Style Editor Dialog
      Floating Object Layout Dialog
      Document Properties Dialog
      Table of Contents Dialog
      Language Dialog
    Services
    Events
    Commands
    HTML Tag Support
   [Expand]Examples
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Table Properties Dialogs

The Table Properties dialog allows end-users to change settings of table rows, columns, particular cells or whole tables.

  • The options on the Table tab allow end-users to set table properties, such as the preferred width for an entire table and table alignment (position of the table relative to the margins of the page).

    The Options... button invokes the Table Options dialog that allows end-users to set default cell margins (spacing between cell borders and text within each cell), along with specifying whether the additional space should be between cells, setting the amount of this space, and setting whether or not table columns should be automatically expanded to accommodate cell content.

  • The Row tab allows end-users to set the height of the table row, enable or disable the row to break across pages, and to specify whether or not the row should be the first row on each page in case the table is more than one page.

  • On the Column tab, end-users can set the preferred width for the table column.

  • Options on the Cell tab allow end-users to set the preferred width of the table cell and select a vertical alignment of the text within the cell.

    The Options... button invokes the Cell Options dialog allowing end-users to customize cell margins (space between cell borders and cell content) and specify whether or not the text within the cell should be wrapped and fitted.

By default, the Table Properties dialog is invoked when an end-user right-clicks a table in the RichEditControl and selects Table Properties... from the context menu.

You can also provide end-users with the capability to invoke the Table Properties dialog via the Table toolbar or Ribbon page group, or Cell Size Ribbon page group. To do this, provide Bars or Ribbon UI for RichEditControl (see Lesson 4 - Provide a Bar UI for a Rich Text Editor or Lesson 5 - Create Separate Ribbon Pages for a Rich Text Editor) and create the Table toolbar, or the Table or Cell Size ribbon page group from the Table group of bars.

Invoke the Table Properties dialog via Bars UI

Invoke the Table Properties dialog via Ribbon UI

To invoke the Table Properties dialog, use the ShowTablePropertiesFormCommand command.

You can programmatically change settings of the table and its elements by using members of the Table, TableRow and TableCell objects.

Is this topic helpful?​​​​​​​