Tareas habituales de edición de texto enriquecido
Hay una serie de tareas que los desarrolladores suelen realizar al editar y procesar documentos de texto con Qt. Entre ellas se incluyen el uso de widgets de visualización como QTextBrowser y QTextEdit, la creación de documentos con QTextDocument, la edición mediante un QTextCursor y la exportación de la estructura del documento. Este documento describe algunas de las formas más habituales de utilizar las clases de texto enriquecido para realizar estas tareas, mostrando patrones prácticos que pueden reutilizarse en tus propias aplicaciones.
Uso de QTextEdit
Se puede crear un widget de editor de texto y utilizarlo para mostrar HTML de la siguiente manera:
QTextEdit *editor = new QTextEdit(parent);
editor->setHtml(aStringContainingHTMLtext);
editor->show();Por defecto, el editor de texto contiene un documento con un marco raíz, en cuyo interior hay un bloque de texto vacío. Este documento se puede obtener para que la aplicación pueda modificarlo directamente:
QTextDocument *document = editor->document();El cursor del editor de texto también se puede utilizar para editar un documento:
QTextCursor cursor = editor->textCursor();Aunque un documento se puede editar utilizando varios cursores a la vez, un ` QTextEdit ` solo muestra un único cursor en cada momento. Por lo tanto, si queremos actualizar el editor para que muestre un cursor concreto o su selección, debemos establecer el cursor del editor después de haber modificado el documento:
editor->setTextCursor(cursor);Selección de texto
El texto se selecciona moviendo el cursor mediante operaciones similares a las que realiza un usuario en un editor de texto. Para seleccionar texto entre dos puntos del documento, debemos situar el cursor en el primer punto y, a continuación, moverlo utilizando un modo especial (QTextCursor::MoveMode) con una operación de desplazamiento (QTextCursor::MoveOperation). Al seleccionar el texto, dejamos el ancla de selección en la posición anterior del cursor, tal y como haría un usuario al mantener pulsada la tecla Mayús al seleccionar texto:
cursor.movePosition(QTextCursor::StartOfWord);
cursor.movePosition(QTextCursor::EndOfWord, QTextCursor::KeepAnchor);En el código anterior, se selecciona una palabra completa utilizando este método. QTextCursor proporciona una serie de operaciones de desplazamiento habituales para seleccionar caracteres individuales, palabras, líneas y bloques completos.
Búsqueda de texto
QTextDocument ofrece una interfaz basada en el cursor para realizar búsquedas, lo que facilita encontrar y modificar texto al estilo de un editor de texto. El siguiente código busca todas las apariciones de una palabra concreta en un documento y cambia el color de cada una de ellas:
QTextCursor newCursor(document);
while (!newCursor.isNull() && !newCursor.atEnd()) {
newCursor = document->find(searchString, newCursor);
if (!newCursor.isNull()) {
newCursor.movePosition(QTextCursor::WordRight,
QTextCursor::KeepAnchor);
newCursor.mergeCharFormat(colorFormat);
}
}Ten en cuenta que no es necesario mover el cursor tras cada operación de búsqueda y sustitución; siempre se coloca al final de la palabra que acaba de sustituirse.
Impresión de documentos
QTextEdit está diseñada para la visualización de documentos de texto enriquecido de gran tamaño que se leen en pantalla, representándolos de la misma forma que un navegador web. Como resultado, no divide automáticamente el contenido del documento en fragmentos del tamaño de una página adecuados para la impresión.
QTextDocument proporciona una función ` print()` que permite imprimir documentos utilizando la clase ` QPrinter `. El siguiente código muestra cómo preparar un documento en un ` QTextEdit ` para imprimirlo con un ` QPrinter`:
QTextDocument *document = editor->document();
QPrinter printer;
QPrintDialog *dlg = new QPrintDialog(&printer, this);
if (dlg->exec() != QDialog::Accepted)
return;
document->print(&printer);El documento se obtiene del editor de texto y, a continuación, se crea un objeto ` QPrinter `, que se configura mediante un ` QPrintDialog`. Si el usuario acepta la configuración de la impresora, el documento se formatea y se imprime mediante la función ` print()`.
© 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.