[Expand]General Information
[Collapse]WinForms Controls
 [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]Map Control
  [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
    Spell Checking
    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
    Keyboard Shortcuts
    HTML Tag Support
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [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]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Editor Elements

The RichEditControl control consists of visual elements that provide end-users with capability of editing and viewing 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 settings of the document views, 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.


The RichEditView.AdjustColorsToSkins property of a current view allows you to adapt the RichEditControl's font color and background color values from the current skin if they are not displayed correctly. Set the AdjustColorsToSkins property to true in the RichEditControl.Load event handler to complete the task.

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 How to: Create a Simple Word Processor with a Bar UI or How to: Create a Simple Word Processor with a Ribbon UI.

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 height of table rows.

By default, visibility of horizontal and vertical rulers depends on the currently selected document view: in the Simple view rulers are hidden, in the Draft view the horizontal ruler is only available, in the 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.Options property. It provides access to various characteristics of the control, among them RichEditControlOptionsBase.HorizontalRuler and RichEditControlOptionsBase.VerticalRuler.

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

Expanded Scrollbars

By default, 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.

However, you can control the visibility of scrollbars via the RichEditControl.Options property. It provides access to various characteristics of the control, among them RichEditControlOptions.HorizontalScrollbar and RichEditControlOptions.VerticalScrollbar.

Expanded End-User Restrictions

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

Restriction Description
RichEditBehaviorOptions.OfficeScrolling Specifies whether or not the Office Scrolling feature is enabled.
RichEditBehaviorOptions.Zooming Specifies whether or not the Zoom operation is permitted.
RichEditBehaviorOptions.MaxZoomFactor Specifies the upper limit of document zooming.
RichEditBehaviorOptions.MinZoomFactor Specifies the lower limit of document zooming.
RichEditBehaviorOptions.OvertypeAllowed Specifies whether or not the overtype mode is allowed.

Expanded See Also

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