QTextDocumentFragment Class▲
-
Header: QTextDocumentFragment
-
CMake:
find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
-
qmake: QT += gui
-
Group: QTextDocumentFragment is part of Rich Text Processing APIs, shared
Detailed Description▲
A QTextDocumentFragment is a fragment of rich text, that can be inserted into a QTextDocument. A document fragment can be created from a QTextDocument, from a QTextCursor's selection, or from another document fragment. Document fragments can also be created by the static functions, fromPlainText() and fromHtml().
The contents of a document fragment can be obtained as raw text by using the toRawText() function, as ASCII with toPlainText(), as HTML with toHtml(), or as Markdown with toMarkdown().
Member Function Documentation▲
QTextDocumentFragment::QTextDocumentFragment()▲
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)▲
Converts the given document into a QTextDocumentFragment. Note that the QTextDocumentFragment only stores the document contents, not meta information like the document's title.
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)▲
Creates a QTextDocumentFragment from the cursor's selection. If the cursor doesn't have a selection, the created fragment is empty.
See Also▲
See also isEmpty(), QTextCursor::selection()
QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)▲
Copy constructor. Creates a copy of the other fragment.
QTextDocumentFragment::~QTextDocumentFragment()▲
Destroys the document fragment.
[static] QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr)▲
Returns a QTextDocumentFragment based on the arbitrary piece of HTML in the given text. The formatting is preserved as much as possible; for example, "<b>bold</b>" will become a document fragment with the text "bold" with a bold character format.
If the provided HTML contains references to external resources such as imported style sheets, then they will be loaded through the resourceProvider.
[static, since 6.4] QTextDocumentFragment QTextDocumentFragment::fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub)▲
Returns a QTextDocumentFragment based on the given markdown text with the specified features. The default is GitHub dialect.
The formatting is preserved as much as possible; for example, **bold** will become a document fragment containing the text "bold" with a bold character style.
Loading external resources is not supported.
This function was introduced in Qt 6.4.
[static] QTextDocumentFragment QTextDocumentFragment::fromPlainText(const QString &plainText)▲
Returns a document fragment that contains the given plainText.
When inserting such a fragment into a QTextDocument the current char format of the QTextCursor used for insertion is used as format for the text.
bool QTextDocumentFragment::isEmpty() const▲
Returns true if the fragment is empty; otherwise returns false.
QString QTextDocumentFragment::toHtml() const▲
Returns the contents of the document fragment as HTML.
See Also▲
See also toPlainText(), toMarkdown(), QTextDocument::toHtml()
[since 6.4] QString QTextDocumentFragment::toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const▲
Returns the contents of the document fragment as Markdown, with the specified features. The default is GitHub dialect.
This function was introduced in Qt 6.4.
See Also▲
See also toPlainText(), QTextDocument::toMarkdown()
QString QTextDocumentFragment::toPlainText() const▲
This function returns the same as toRawText(), but will replace some unicode characters with ASCII alternatives. In particular, no-break space (U+00A0) is replaced by a regular space (U+0020), and both paragraph (U+2029) and line (U+2028) separators are replaced by line feed (U+000A). If you need the precise contents of the document, use toRawText() instead.
See Also▲
See also toHtml(), toMarkdown(), toRawText()
[since 6.4] QString QTextDocumentFragment::toRawText() const▲
Returns the document fragment's text as raw text (i.e. with no formatting information).
This function was introduced in Qt 6.4.
See Also▲
See also toHtml(), toMarkdown(), toPlainText()
QTextDocumentFragment &QTextDocumentFragment::operator=(const QTextDocumentFragment &other)▲
Assigns the other fragment to this fragment.