[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
  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]Gantt Control
  [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
    Hyphenation
    Spell Checking
    AutoCorrect Feature
    Track Changes
    Mail Merge
    Restrictions and Protection
   [Expand]Visual Elements
    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]Sunburst 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]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Rich Text Editor

Overview

The Rich Text Editor is a powerful word-processing tool that allows you to create, load, modify, print and export rich text documents in different formats. The RichEditControl processes text with any text direction. The Rich Text Editor provides numerous features, such as Import and Export options, conversion between different measurement units, field support, etc.

Follow the Getting Started tutorial to create a simple word processing application in Microsoft Visual Studio. Look through the Examples section to learn how to accomplish different tasks. Check the Product Class Structure topic to access reference information on major Rich Editor classes.

Document Elements

A document created by the Rich Text Editor consists of elements visible to end users. They vary from the simplest objects forming the text, to more complex ones that can contain other elements. These are:

  • Paragraphs

    Portions of text organized by a specific collection of characters.

  • Fields

    Placeholders added to a document. Fields can be used to perform a variety of operations, including Table of Contents and Mail Merge.

  • Lists

    Linearly organized paragraphs. You can group any paragraph into a bulleted, numbered or multilevel list in code or with the UI.

  • Tables

    A paragraph formatted in aligned rows and columns. The Rich text Editor supports complex tables. Tables can be added, deleted and modified in code or in the UI.

  • Pictures

    Pictures can be inserted within the text (the text wrapping is optional), behind or above it. The RichEditControl supports different image formats.

  • Shapes

    The RichEditControl supports all shape types: from simple lines and rectangles, to shapes with advanced effects. All shapes can be moved, resized and rotated.

  • Comments

    Notes with additional content. Comments can make a document more understandable.

  • Hyperlinks and Bookmarks

    Links to the specific place within a document (bookmarks), existing file or web page(hyperlinks).

  • Checkboxes

    Interactive form fields used to create fillable forms.

Developer Guidelines

The RichEditControl carries out various features that allow you to create a powerful and fully customizable text editing application, such as:

  • A variety of Events, which allow you to track end user actions to perform necessary operations.
  • A comprehensive set of Services used to build feature-rich applications.
  • Three types of protection that can be used to prevent end-users from modifying the document, like character or paragraph formatting, clipboard operations or printing.
  • The autocorrect service that analyzes the entered text and automatically fixes errors based on specific rules and permissions.
  • The Spell Checking feature that allows the Rich Text Editor to highlight words with possible errors that were not fixed by auto correction.

Views

The Rich Text Editor is able to display documents in three different ways depending on the document View:

  • Similar to the 'Web Layout' view in Microsoft Word, the Simple View does not split the document into pages, so the document has no page width or height, margins, headers or footers. This View is most appropriate for editing simple texts.

  • Same as the Microsoft Word's 'Draft View', the Rich Text Editor Draft View displays documents as a single page without headers or footers, but applies the page width. This View can be used for text formatting.

  • The Print Layout View displays your documents in the same way they will appear on the printed page, with all their headers, footers, margins and columns. Use this View when you need to polish your document and prepare it for printing.

Formatting Documents

The Rich Text Editor allows you to format document text directly (i.e., change individual formatting attributes) or use paragraph and character style.

Change layout of the document pages: add Headers and Footers or use settings like page orientation, paper kind or margins. You can design the first page of your document by applying its own layout settings and hiding its header and footer to start numbering from the second page.

You can build a Table of Contents to provide a document with quick navigation to each part of the document. It can be organized from the entire document or from any part of a text marked with a bookmark.

Expanded See Also

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