[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
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Collapse]Rich Text Editor
   [Expand]Product Information
    Product Class Structure
    Supported Formats
   [Expand]Getting Started
   [Expand]RichEditControl Document
    Text Formatting
    Import and Export
   [Expand]Page Layout
    Mail Merge
    Restrictions and Protection
    Syntax Highlighting
   [Collapse]Visual Elements
    [Collapse]Rich Edit Control
      Editor Elements
      Reviewing Pane
      Horizontal Ruler
      Vertical Ruler
    [Expand]Command UI
     Pop-up Menus
    HTML Tag Support
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Editor Elements

The RichEditControl control consists of visual elements that provide end-users with the capability to edit and view documents.

Expanded Document Views

The main area of RichEditControl is the Text Editing Surface that displays a document to be edited. Here, a document can look as it will appear when it is printed (PrintLayoutView), or with reduced formatting and pagination (SimpleView or DraftView). To get access to document views' settings, use the RichEditControl.Views property. The currently selected view is accessible via the RichEditControl.ActiveView property. To select another view, use the RichEditControl.ActiveViewType property, or call the SwitchToSimpleViewCommand, SwitchToDraftViewCommand or SwitchToPrintLayoutViewCommand command.


Set the RichEditView.AdjustColorsToSkins property of a current view to true in the RichEditControl.Loaded event handler to adapt the RichEditControl's text editing surface elements to the current theme.

To provide end-users with the capability to switch document views depending on their tasks, you can accompany RichTextControl with the Document Views toolbar or Ribbon page group. To get an example on how to provide Bars or Ribbon UI for a RichTextControl, see Lesson 4 - Provide a Bar UI for a Rich Text Editor or Lesson 5 - Create Separate Ribbon Pages for a Rich Text Editor.

Expanded Rulers

On the top and the left of the Text Editing Surface, RichEditControl displays horizontal and vertical rulers, which end-users can use to change table column width and row height, align text, graphics, and other elements in a document.

The Horizontal Ruler controls the width of table columns and the horizontal spacing of paragraph margins and tabs.

The Vertical Ruler allows you to set the top and bottom margins of the document, and change the height of table rows.

By default, visibility of horizontal and vertical rulers depends on the currently selected document view: in a Simple view - rulers are hidden, in a Draft view - only the horizontal ruler is available, in a Print Layout view - both horizontal and vertical rulers are shown.

However, you can hide or display rulers independently of the document views by using the RichEditControl.HorizontalRulerOptions and RichEditControl.VerticalRulerOptions properties.

To enable end-users to change the visibility of rulers, you can provide the Show toolbar or the Ribbon page group for RichEditControl.

Expanded Scrollbars

The document view can display horizontal and vertical scrollbars when needed, i.e. if a page does not fit into the control's display area. You can control the scrollbars' visibility using the RichEditControl.HorizontalScrollBarVisibility and the RichEditControl.VerticalScrollBarVisibility properties.

When you scroll down a document using vertical a scrollbar, the popup window with the page number appears.

Set the DXRichEditBehaviorOptions.ShowPageNumberToolTip property to false to hide the Page Number window.

Expanded End-User Restrictions

You can implement restrictions to prevent end-users from changing the editing surface. Use the RichEditControl.BehaviorOptions to access one of the following restriction settings:

Restriction Description
DXRichEditBehaviorOptions.OfficeScrolling Gets or sets if the Office Scrolling feature is enabled. This is a dependency property.
DXRichEditBehaviorOptions.Zooming Gets or sets whether the Zoom operation is permitted. This is a dependency property.
DXRichEditBehaviorOptions.MaxZoomFactor Gets or sets the upper limit of document zooming. This is a dependency property.
DXRichEditBehaviorOptions.MinZoomFactor Gets or sets the lower limit of document zooming. This is a dependency property.
DXRichEditBehaviorOptions.OvertypeAllowed Gets or sets whether the overtype feature is allowed. This is a dependency property.

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