Rich Text Processing
Qt provides a set of classes for creating, editing, and rendering structured rich text documents. These classes center around QTextDocument, which represents a rich text document with a well-defined internal structure. Working directly with QTextDocument allows applications to create, modify, and inspect rich text without relying on intermediate markup formats.
You can access document information via two complementary interfaces:
| Interface | Description |
|---|---|
| Cursor-based interface (QTextCursor) | Supports editing operations that mimic user actions in a text editor. Edits maintain the structural integrity of the underlying document. |
| Read-only hierarchical interface | Provides a high-level structural view of the document. It is useful for tasks such as searching, inspection, and exporting content. |
Rich Text Serialization
QTextDocument supports serialization to and from these markup formats:
- HTML: A defined subset of HTML is supported for loading and saving. See Supported HTML Subset.
- Markdown: QTextDocument can parse Markdown in both CommonMark and GitHub dialects.
Rich Text Topics
- Rich Text Document Structure describes the different elements in a QTextDocument and how they are arranged in a document structure.
- The QTextCursor Interface explains how to edit rich text documents using the cursor-based interface.
- Document Layouts describes how to visually arrange document contents.
- Common Rich Text Editing Tasks describes frequently used operations for reading and manipulating rich text such as selecting, searching, and printing.
- Advanced Rich Text Processing describes advanced rich text editing tasks such as handling large files.
- Supported HTML Subset lists the HTML tags supported by QTextDocument.
Rich Text Processing APIs
Qt provides an extensive collection of classes for parsing, rendering manipulating and editing rich text.
Abstract base class used to implement custom layouts for QTextDocuments | |
Specifies a query for a font used for drawing text | |
Implements a plain text layout for QTextDocument | |
Widget that is used to edit and display plain text | |
Allows you to define syntax highlighting rules, and in addition you can use the class to query a document's current formatting or user data | |
Container for text fragments in a QTextDocument | |
QTextBlock::iterator class provides an iterator for reading the contents of a QTextBlock | |
Formatting information for blocks of text in a QTextDocument | |
Container for text blocks within a QTextDocument | |
Used to associate custom data with blocks of text | |
Rich text browser with hypertext navigation | |
Formatting information for characters in a QTextDocument | |
Offers an API to access and modify QTextDocuments | |
Holds formatted text | |
Represents a piece of formatted text from a QTextDocument | |
Format-independent interface for writing a QTextDocument to files or other devices | |
Widget that is used to edit and display both plain and rich text | |
Formatting information for a QTextDocument | |
Holds a piece of text in a QTextDocument with a single QTextCharFormat | |
Represents a frame in a QTextDocument | |
Iterator for reading the contents of a QTextFrame | |
Formatting information for frames in a QTextDocument | |
Formatting information for images in a QTextDocument | |
Represents an inline object in a QAbstractTextDocumentLayout and its implementations | |
Used to lay out and render text | |
Encapsulates the different types of length used in a QTextDocument | |
Represents a line of text inside a QTextLayout | |
Decorated list of items in a QTextDocument | |
Formatting information for lists in a QTextDocument | |
Base class for different kinds of objects that can group parts of a QTextDocument together | |
Description of general rich text properties | |
Represents a table in a QTextDocument | |
Represents the properties of a cell in a QTextTable | |
Formatting information for table cells in a QTextDocument | |
Formatting information for tables in a QTextDocument |
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
