Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [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
    Spell Checking
    AutoCorrect
    Mail Merge
    Restrictions and Protection
    Syntax Highlighting
    Traversing the Document
   [Collapse]Visual Elements
    [Expand]Rich Edit Control
    [Expand]Command UI
    [Collapse]Dialogs
      Paste Special Dialog
      Font Dialog
      Paragraph and Tabs Dialogs
      Bullets and Numbering Dialog
      Find and Replace Dialog
      Symbol Dialog
      Bookmark Dialog
      Edit Hyperlink Dialog
      Page Setup Dialog
      Columns Dialog
      Line Numbers Dialog
      Insert Merge Field Dialog
      Document Protection Dialogs
      Editing Permissions Dialog
      Table Layout Dialogs
      Table Style Dialog
      Table Properties Dialogs
      Borders and Shading Dialog
      Style Editor Dialog
      Floating Object Layout Dialog
      Document Properties Dialog
      Table of Contents Dialog
      Language Dialog
     Pop-up Menus
    [Expand]Views
    Services
    Events
    Commands
    Keyboard Shortcuts
    HTML Tag Support
   [Expand]Examples
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Table Layout Dialogs

The RichEditControl provides a number of dialogs, which allows end-users to work with tables: insert new tables into the document, as well as insert, delete and split individual cells of existing tables.

Expanded Insert Table

The Insert Table dialog allows end-users to insert a new table with the specified number of rows and columns into a document.

End-users can invoke this dialog by clicking Table on the Insert ribbon tab. Refer to the How to: Create a Simple Word Processor with a Ribbon UI topic for details on how to create the Ribbon UI for the RichEditControl. Executing the InsertTableCommand command invokes this dialog as well.

The maximum number of rows in the RichEditControl table is 32767, the maximum number of columns is 63. If an end-user enters the number of rows or columns that exceed the limit, an error icon appears, as shown below.

To customize the default Insert Table dialog (modify captions, set default dialog values, implement custom validation, etc.) or substitute it with completely new dialog, handle the RichEditControl.InsertTableFormShowing event.

Also, you can programmatically insert a new table into the document. To do this, call the TableCollection.Create API method.

Expanded Insert Cells

The Insert Cells dialog enables end-users to insert a cell into the existing table and select the way to adjust table cells.

End-users can invoke this dialog by clicking the Insert Cells dialog box launcher on the Table Tools | Layout ribbon tab...

...or from the context menu by selecting Insert > Insert Cells.

Refer to the How to: Create a Simple Word Processor with a Ribbon UI topic for details on how to create the Ribbon UI for the RichEditControl. Executing the ShowInsertTableCellsFormCommand command invokes this dialog as well.

To customize the default Insert Cells dialog (modify captions, set default dialog values, implement custom validation, etc.) or substitute it with completely new dialog, handle the RichEditControl.InsertTableCellsFormShowing event.

Expanded Delete Cells

The Delete Cells dialog enables end-users to delete particular cells form a table and select a way of adjusting table cells.

End-users can invoke this dialog by clicking Delete on the Table Tools | Layout ribbon tab and selecting Delete Cells item from the invoked drop-down menu. Refer to the How to: Create a Simple Word Processor with a Bar UI topic for details on how to create the Ribbon UI for the RichEditControl. Executing the ShowDeleteTableCellsFormCommand command invokes this dialog as well.

The dialog is also available from the context menu.

To customize the default Delete Cells dialog (modify captions, set default dialog values, implement custom validation, etc.) or substitute it with completely new dialog, handle the RichEditControl.DeleteTableCellsFormShowing event.

Expanded Split Cells

The Split Cells dialog enables end-users to split the selected cells into the specified number of rows and columns.

End-users can invoke this dialog by clicking Split Cells on the Table Tools | Layout ribbon tab...

... or from the context menu.

Refer to the How to: Create a Simple Word Processor with a Ribbon UI topic for details on how to create the Ribbon UI for the RichEditControl. Executing the ShowSplitTableCellsFormCommand command invokes this dialog as well.

To customize the default Split Cells dialog (modify captions, set default dialog values, implement custom validation, etc.) or substitute it with completely new dialog, handle the RichEditControl.SplitTableCellsFormShowing event.

Expanded See Also

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