Rich Text Editor

• Jul 05, 2018
• 5 minutes to read

Overview

The Rich Text Edit control is a powerful word-processing tool that allows you to create, load, modify, print, save and convert rich text documents in different formats. The DXRichEdit Suite provides numerous features, such as importing and exporting options, multiple predefined document layouts , conversion between different measurement units, field support, etc. To get started with the Rich Text Editor and create simple word processing applications in MS Visual Studio, follow the Getting Started tutorial. Look through the Examples section to learn how to accomplish different tasks using the Rich Text Editor API. 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: Characters - simple objects that build regular plain text. Paragraphs - portions of text organized by a specific collection of characters. Fields - placeholders added to a document, providing a mechanism to replace them with corresponding values when the document is rendered for display or print. Fields can be used to perform a variety of operations, including creating a table of contents and mail merging. 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 RichEdit control provides support for complex tables, as well as nested ones. Tables can be added, deleted and modified in code or in the UI. Inline Pictures - images presented in the text stream. The picture can be inserted within the text (the text wrapping is optional), behind or above it. Different image formats are supported. Floating Objects - images or shapes that are strictly positioned, absolutely or relatively within the document, regardless of the text flow. It includes text boxes that are shapes containing editable text strings. All floating objects can be moved, resized and rotated. Comments - notes that can be added to a document. They are also strictly positioned and can contain a text string or image. Comments can make a document more understandable by providing additional context for the data it contains. Hyperlinks and Bookmarks - elements that allow you to quickly navigate to the specific place within a document (bookmarks), to point to an existing file or web page, or to mark the specific document range (hyperlinks).

Developer Guidelines

The DXRichEdit carries out various features that allow you to create a powerful and fully customizable text editing application, such as: Commands, which can help you to accomplish different tasks, such as inserting characters and pictures, selection, formatting, creating numbered lists, scrolling, etc. A variety of events accompanying different processes, which allow you to track end-user actions to perform necessary operations. A comprehensive set of services exposed by the Rich Edit Control, that enable you to build feature-rich applications. Three types of protection that can be used to restrict an end-user’s ability to modify the document, like character or paragraph formatting, clipboard operations or printing. The mail merging feature that can help you to create a document template for letters, catalogs, mailing labels and for personalizing any kind of document. The embedded autocorrection 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.

Formatting Documents

Characters can be formatted using different settings for font, font size, character style (bold, italics, underlined, strike-through style) and different colors for background and foreground. You can specify the type of characters you want to highlight with different colors and fonts as they appear in the text. Each of the document sections can have its own set of headers and footers and 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. Formatting paragraph alignment, style or line spacing is also entirely supported. If there is a table inserted in the document, you can edit its layout by inserting more rows or columns and splitting or merging cells. Borders and shading can be applied individually for each cell in a table. Any image in the document can be resized, moved or rotated. You can change the text wrapping and place the image behind, above or within the text. To provide a document with quick navigation to each part of the document, you can build a table of contents. It can be organized from the entire document or from any part of a text marked with a bookmark.