QTextDocumentFragment Class
La clase QTextDocumentFragment representa un fragmento de texto formateado de un QTextDocument. Más...
| Cabecera: | #include <QTextDocumentFragment> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluyendo los heredados
- QTextDocumentFragment es parte de APIs de Procesamiento de Texto Enriquecido y Clases Implícitamente Compartidas.
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 una selección de 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 puede obtenerse 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 miembro
QTextDocumentFragment::QTextDocumentFragment()
Construye un QTextDocumentFragment vacío.
Véase también isEmpty().
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)
Crea un QTextDocumentFragment a partir de la selección de cursor. Si el cursor no tiene una selección, el fragmento creado estará vacío.
Véase también isEmpty() y QTextCursor::selection().
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)
Convierte el document dado en un QTextDocumentFragment. Tenga en cuenta que QTextDocumentFragment sólo almacena el contenido del documento, no meta información como el título del documento.
QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)
Constructor de copia. Crea una copia del fragmento other.
[noexcept] QTextDocumentFragment::~QTextDocumentFragment()
Destruye el fragmento de documento.
[static] QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr)
Devuelve un QTextDocumentFragment basado en el fragmento arbitrario de HTML en el text dado. El formato se conserva en la medida de lo posible; por ejemplo, "<b>negrita</b>" se convertirá en un fragmento de documento con el texto "negrita" con un formato de caracteres en negrita.
Si el HTML proporcionado contiene referencias a recursos externos, como hojas de estilo importadas, 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 dado markdown con el features especificado. 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 contiene el texto "negrita" con un estilo de carácter negrita.
Nota: La carga de recursos externos no está soportada.
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 dado.
Al insertar un fragmento de este tipo en QTextDocument, se utiliza como formato para el texto el formato de caracteres actual de 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 como 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 como Markdown, con el dialecto features especificado. El valor predeterminado 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 lo mismo que toRawText(), pero sustituirá algunos caracteres unicode por alternativas ASCII. En particular, el espacio sin salto (U+00A0) se sustituye por un espacio normal (U+0020), y los separadores de párrafo (U+2029) y línea (U+2028) se sustituyen por un salto de línea (U+000A). Si necesita el contenido exacto del documento, utilice toRawText() en su lugar.
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.