QTextDocumentFragment Class
La clase `QTextDocumentFragment` representa un fragmento de texto con formato procedente de un ` QTextDocument`. Más información...
| Encabezado: | #include <QTextDocumentFragment> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluidos los heredados
- QTextDocumentFragment forma parte de las API de procesamiento de texto enriquecido y de las clases compartidas implícitamente.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QTextDocumentFragment() | |
| QTextDocumentFragment(const QTextCursor &cursor) | |
| QTextDocumentFragment(const QTextDocument *document) | |
| QTextDocumentFragment(const QTextDocumentFragment &other) | |
| ~QTextDocumentFragment() | |
| bool | isEmpty() const |
| QString | toHtml() const |
(since 6.4) QString | toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const |
| QString | toPlainText() const |
(since 6.4) QString | toRawText() const |
| QTextDocumentFragment & | operator=(const QTextDocumentFragment &other) |
Miembros públicos estáticos
| QTextDocumentFragment | fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr) |
(since 6.4) QTextDocumentFragment | fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) |
| QTextDocumentFragment | fromPlainText(const QString &plainText) |
Descripción detallada
Un QTextDocumentFragment es un fragmento de texto enriquecido que puede insertarse en un QTextDocument. Un fragmento de documento puede crearse a partir de un QTextDocument, de la selección de un QTextCursor o de otro fragmento de documento. Los fragmentos de documento también pueden crearse mediante las funciones estáticas fromPlainText() y fromHtml().
El contenido de un fragmento de documento se puede obtener como texto sin formato mediante la función toRawText(), como ASCII con toPlainText(), como HTML con toHtml() o como Markdown con toMarkdown().
Documentación de las funciones de miembro
QTextDocumentFragment::QTextDocumentFragment()
Crea un objeto QTextDocumentFragment vacío.
Véase también isEmpty().
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)
Crea un QTextDocumentFragment a partir de la selección del cursor. Si el cursor no tiene ninguna selección, el fragmento creado estará vacío.
Véase también isEmpty() y QTextCursor::selection().
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)
Convierte el objeto ` document ` proporcionado en un `QTextDocumentFragment`. Ten en cuenta que el `QTextDocumentFragment` solo almacena el contenido del documento, no la metainformación, como el título del mismo.
QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)
Constructor de copia. Crea una copia del fragmento « other ».
[noexcept] QTextDocumentFragment::~QTextDocumentFragment()
Elimina el fragmento del documento.
[static] QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr)
Devuelve un ` QTextDocumentFragment ` basado en el fragmento arbitrario de HTML que aparece en el ` text` proporcionado. Se conserva el formato en la medida de lo posible; por ejemplo, «<b>bold</b>» se convertirá en un fragmento de documento con el texto «bold» y el formato de caracteres en negrita.
Si el código HTML proporcionado contiene referencias a recursos externos, como hojas de estilo importadas, estas se cargarán a través de resourceProvider.
[static, since 6.4] QTextDocumentFragment QTextDocumentFragment::fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub)
Devuelve un « QTextDocumentFragment » basado en el texto « markdown » proporcionado, con el « features » especificado. El valor por defecto es el dialecto de GitHub.
El formato se conserva en la medida de lo posible; por ejemplo, **bold** se convertirá en un fragmento de documento que contenga el texto «bold» con un estilo de carácter en negrita.
Nota: No se admitela carga de recursos externos.
Esta función se introdujo en Qt 6.4.
[static] QTextDocumentFragment QTextDocumentFragment::fromPlainText(const QString &plainText)
Devuelve un fragmento de documento que contiene el ` plainText` indicado.
Al insertar dicho fragmento en un QTextDocument, se utiliza como formato del texto el formato de caracteres actual del QTextCursor utilizado para la inserción.
bool QTextDocumentFragment::isEmpty() const
Devuelve « true » si el fragmento está vacío; en caso contrario, devuelve « false ».
QString QTextDocumentFragment::toHtml() const
Devuelve el contenido del fragmento de documento en formato HTML.
Véase también toPlainText(), toMarkdown() y QTextDocument::toHtml().
[since 6.4] QString QTextDocumentFragment::toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const
Devuelve el contenido del fragmento del documento en formato Markdown, utilizando el dialecto especificado en ` features`. El valor por defecto es el dialecto de GitHub.
Esta función se introdujo en Qt 6.4.
Véase también toPlainText() y QTextDocument::toMarkdown().
QString QTextDocumentFragment::toPlainText() const
Esta función devuelve el mismo resultado que « toRawText()», pero sustituye algunos caracteres Unicode por sus equivalentes ASCII. En concreto, el espacio no separable (U+00A0) se sustituye por un espacio normal (U+0020), y tanto los separadores de párrafo (U+2029) como los de línea (U+2028) se sustituyen por un salto de línea (U+000A). Si necesitas el contenido exacto del documento, utiliza en su lugar toRawText().
Véase también toHtml(), toMarkdown() y toRawText().
[since 6.4] QString QTextDocumentFragment::toRawText() const
Devuelve el texto del fragmento del documento como texto sin formato (es decir, sin información de formato).
Esta función se introdujo en Qt 6.4.
Véase también toHtml(), toMarkdown() y toPlainText().
QTextDocumentFragment &QTextDocumentFragment::operator=(const QTextDocumentFragment &other)
Asigna el fragmento « other » a este fragmento.
© 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.