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]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
   [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
      List Dialogs
      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 Properties Dialogs
      Borders and Shading Dialog
      Style Editor Dialog
      Inline and Floating Object Layout Dialog
      Table Style Dialog
      Document Properties Dialog
      Table of Contents Dialog
      Language Dialog
     Pop-up Menus
    [Expand]Views
    Services
    Events
    Commands
   [Expand]Member Tables
    Keyboard Shortcuts
    HTML Tag Interpretation
   [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]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

Columns Dialog

When working in the RichEditControl, end-users can lay out text in columns. The Columns dialog enables end-users to set the number of columns to be created in a particular section or the whole document, and to specify the width of individual columns and between columns.

You can provide end-users with the capability to invoke the Columns dialog via the Page Setup toolbar or Ribbon page group. To do this, provide Bars or Ribbon UI for the RichEditControl (see How to: Create a Simple Word Processor with a Bar UI or How to: Create a Simple Word Processor with a Ribbon UI) and create the Page Setup toolbar or Ribbon page group from the Page Layout group of bars.

To invoke the dialog, use the ShowColumnsSetupFormCommand command.

To programmatically operate with columns in the section, use the SectionColumns interface accessed via the Section.Columns property. Each individual column in the section layout is represented by the SectionColumn object.

Note

The maximum number of columns that can be set for the current section, depends on the document orientation (SectionPage.Landscape) and currently selected paper size (SectionPage.PaperKind).

To customize the default Columns dialog (modify captions, set default dialog values, implement custom validation, etc.) or substitute it with completely new dialog, handle the RichEditControl.ColumnsSetupFormShowing event. To get an example of the dialog replacement, refer to the How to: Customize the Search Form or How to: Customize the Hyperlink Form document.

Expanded See Also

How would you rate this topic?​​​​​​​