[Expand]General Information
[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
   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
   [Collapse]RichEditControl Document
    [Expand]Document Structure
    [Collapse]Document Elements
      Positions and Ranges
      Characters
      Paragraphs
      Inline Pictures
      Hyperlinks and Bookmarks
      Headers and Footers
      Tables
      Range Permissions
      Sections
      Styles
      Lists
      Floating Objects
      Text Boxes
      Comments
      Checkboxes
      Document Properties
   [Expand]Fields
    Text Formatting
    Import and Export
   [Expand]Page Layout
    Printing
    AutoCorrect
    Mail Merge
    Restrictions and Protection
    Syntax Highlighting
    Traversing the Document
   [Expand]Visual Elements
    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]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [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]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

Sections

The DXRichEdit provides the following ways to manage document sections:

Expanded Sections in the User Interface

You can insert section breaks and set the page layout options using the Page Layout ribbon tab. Refer to the Lesson 1 - Create a Simple Rich Text Editor topic for information on how to add a Ribbon UI to the RichEditControl.

The RichEditControl ships with the Page Setup Dialog. This dialog allows end-users to define a page's formatting options of a whole document or a particular section.

Tip

Set the DXRichEditDocumentCapabilitiesOptions.Sections property to Hidden or Disabled to restrict end-users from managing certain document sections.

Expanded Divide a Document into Sections in Code

The Document.Sections property provides access to the document's section collection. Use the following methods to insert a section in code:

Specify the Section.StartType property to define the section break's type.

Note

The RichEditControl does not support column and continuous section breaks.

Execute one of the following commands to insert a specific section break:

Command Description
InsertSectionBreakEvenPageCommand Inserts a section break and starts a new section on the next even-numbered page.
InsertSectionBreakNextPageCommand Inserts a section break and starts a new section on the next page.
InsertSectionBreakOddPageCommand Inserts a section break and starts a new section on the next odd-numbered page.

Expanded Define Page Formatting Options

The RichEditControl provides the following commands to modify page formatting settings:

Command Description
SetModerateSectionPageMarginsCommand Sets the top and bottom margins at one inch and the lateral margins at .75 inches.
SetNarrowSectionPageMarginsCommand Sets all margins at half-an-inch.
SetNormalSectionPageMarginsCommand Sets all margins at one inch.
SetWideSectionPageMarginsCommand Sets vertical margins at one inch and side margins at two inches.
SetSectionOneColumnCommand Sets the section to have only one column.
SetSectionTwoColumnsCommand Sets the section to have two columns.
SetSectionThreeColumnsCommand Sets the section to have three columns.

Each section has page formatting options. You can use the SectionPage class properties to specify the page's paper type, orientation, margins, etc. Use the Section.Page property to access theSectionPage object .

The code sample below specifies the first section's page formatting options, sets the portrait orientation and the A3 Extra paper size.

Expanded Line Numbering and Columns

Set the Section.LineNumbering property to a non-zero value to enable line numbering. Refer to the Line Numbering topic for more information.

Call the SectionColumns.CreateUniformColumns method to create a multi-column layout. Refer to the How to: Create a Three-Column Layout with Uniform Columns topic for more information.

Expanded Page Numbering

Each document section has its own page numbering settings (page number format, initial number, etc.). Use the Section.PageNumbering property to access the SectionPageNumbering class properties and specify section's page numbering options. You should reset the numbering options by setting the SectionPageNumbering.ContinueNumbering property to false before you apply new options. The PAGE field represents a document's page number. To apply new settings to existing page numbers, call the FieldCollection.Update method to update all fields.

The code sample below specifies the initial number and the NumberingFormat.CardinalText numbering format.

Expanded Headers and Footers

Each section Headers and footers in the document belong to a particular section. You can use the Section.BeginUpdateHeader - Section.EndUpdateHeader and the Section.BeginUpdateFooter - Section.EndUpdateHeader method pairs to edit header or footer content. Refer to the Headers and Footers topic for more information.

Expanded See Also

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