QTextFragment Class
La clase QTextFragment contiene un fragmento de texto en un objeto ` QTextDocument ` con un único ` QTextCharFormat`. Más información...
| Cabecera: | #include <QTextFragment> |
| 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
- QTextFragment forma parte de las API de procesamiento de texto enriquecido.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QTextFragment() | |
| QTextFragment(const QTextFragment &other) | |
| QTextCharFormat | charFormat() const |
| int | charFormatIndex() const |
| bool | contains(int position) const |
| QList<QGlyphRun> | glyphRuns(int pos = -1, int len = -1) const |
| bool | isValid() const |
| int | length() const |
| int | position() const |
| QString | text() const |
| bool | operator!=(const QTextFragment &other) const |
| bool | operator<(const QTextFragment &other) const |
| QTextFragment & | operator=(const QTextFragment &other) |
| bool | operator==(const QTextFragment &other) const |
Descripción detallada
Un fragmento de texto describe una parte de texto almacenada con un único formato de caracteres. El texto en el que cambia el formato de los caracteres puede representarse mediante secuencias de fragmentos de texto con diferentes formatos.
Si el usuario edita el texto de un fragmento e introduce un formato de caracteres diferente, el texto del fragmento se dividirá en cada punto en el que cambie el formato y se crearán nuevos fragmentos. Por ejemplo, cambiar el estilo de parte del texto en medio de una frase hará que el fragmento se divida en tres fragmentos independientes: el primero y el tercero con el mismo formato que antes, y el segundo con el nuevo estilo. El primer fragmento contendrá el texto desde el principio de la frase, el segundo contendrá el texto desde la mitad y el tercero, el texto desde el final de la frase.

El texto y el formato de los caracteres de un fragmento se pueden obtener mediante las funciones « text »() y « charFormat »(). La función « length »() devuelve la longitud del texto del fragmento. La función « position »() devuelve la posición en el documento donde comienza el fragmento. Para determinar si el fragmento contiene una posición concreta dentro del documento, utilice la función « contains »().
Véase también « QTextDocument » y «Estructura de un documento de texto enriquecido».
Documentación de las funciones de miembro
QTextFragment::QTextFragment()
Crea un nuevo fragmento de texto vacío.
QTextFragment::QTextFragment(const QTextFragment &other)
Copia el contenido (texto y formato) del fragmento de texto « other » a este fragmento de texto.
QTextCharFormat QTextFragment::charFormat() const
Devuelve el formato de caracteres del fragmento de texto.
Véase también text().
int QTextFragment::charFormatIndex() const
Devuelve un índice de la lista interna de formatos de caracteres del documento correspondiente al formato de caracteres del fragmento de texto.
Véase también QTextDocument::allFormats().
bool QTextFragment::contains(int position) const
Devuelve « true » si el fragmento de texto contiene el texto que se encuentra en la dirección position del documento; en caso contrario, devuelve « false ».
QList<QGlyphRun> QTextFragment::glyphRuns(int pos = -1, int len = -1) const
Devuelve los glifos correspondientes a len caracteres de este fragmento de texto a partir de la posición pos. Las posiciones de los glifos son relativas respecto a la posición de la disposición de QTextBlock.
Si pos es menor que cero, se tomará por defecto el inicio de QTextFragment. Si len es menor que cero, se tomará por defecto la longitud del fragmento.
Véase también QGlyphRun, QTextBlock::layout(), QTextLayout::position() y QPainter::drawGlyphRun().
bool QTextFragment::isValid() const
Devuelve « true » si se trata de un fragmento de texto válido (es decir, si ocupa una posición válida en un documento); en caso contrario, devuelve « false ».
int QTextFragment::length() const
Devuelve el número de caracteres del fragmento de texto.
Véase también text().
int QTextFragment::position() const
Devuelve la posición de este fragmento de texto en el documento.
QString QTextFragment::text() const
Devuelve el fragmento de texto como texto sin formato.
Véase también length() y charFormat().
bool QTextFragment::operator!=(const QTextFragment &other) const
Devuelve « true » si este fragmento de texto es diferente (se encuentra en una posición distinta) del fragmento de texto « other »; en caso contrario, devuelve «false».
bool QTextFragment::operator<(const QTextFragment &other) const
Devuelve « true » si este fragmento de texto aparece antes en el documento que el fragmento de texto « other »; en caso contrario, devuelve « false ».
QTextFragment &QTextFragment::operator=(const QTextFragment &other)
Asigna el contenido (texto y formato) del fragmento de texto « other » a este fragmento de texto.
bool QTextFragment::operator==(const QTextFragment &other) const
Devuelve « true » si este fragmento de texto es igual (en la misma posición) que el fragmento de texto « other »; en caso contrario, devuelve « false ».
© 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.