En esta página

QTextObject Class

La clase QTextObject es una clase base para distintos tipos de objetos que pueden agrupar partes de un QTextDocument. Más información...

Encabezado: #include <QTextObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QObject
Heredado por:

QTextBlockGroup y QTextFrame

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QTextDocument *document() const
QTextFormat format() const
int formatIndex() const
int objectIndex() const

Funciones protegidas

QTextObject(QTextDocument *document)
virtual ~QTextObject()
void setFormat(const QTextFormat &format)

Descripción detallada

Los objetos de texto agrupados más comunes son las listas (QTextList), los marcos (QTextFrame) y las tablas (QTextTable). Cada objeto de texto tiene asociados los métodos format() y document().

Existen básicamente dos tipos de objetos de texto: los que se utilizan con bloques (formatos de bloque) y los que se utilizan con caracteres (formatos de carácter). Los primeros derivan de QTextBlockGroup, y los segundos, de QTextFrame.

Rara vez es necesario utilizar esta clase directamente. Al crear objetos de texto personalizados, también tendrás que reimplementar ` QTextDocument::createObject()`, que actúa como método de fábrica para crear objetos de texto.

Véase también QTextDocument.

Documentación de las funciones de miembro

[explicit protected] QTextObject::QTextObject(QTextDocument *document)

Crea un nuevo QTextObject para el document especificado.

Advertencia: Esta función nunca debe llamarse directamente, sino únicamente desde ` QTextDocument::createObject()` ().

[virtual noexcept protected] QTextObject::~QTextObject()

Elimina el objeto de texto.

Advertencia: Los objetosde texto pertenecen al documento, por lo que nunca debes eliminarlos por tu cuenta.

QTextDocument *QTextObject::document() const

Devuelve el documento al que pertenece este objeto.

Véase también ` format()`.

QTextFormat QTextObject::format() const

Devuelve el formato del objeto de texto.

Véase también setFormat() y document().

int QTextObject::formatIndex() const

Devuelve el índice del formato del objeto en la lista interna de formatos del documento.

Véase también QTextDocument::allFormats().

int QTextObject::objectIndex() const

Devuelve el índice de este objeto. Se puede utilizar junto con la función « QTextFormat::setObjectIndex()».

[protected] void QTextObject::setFormat(const QTextFormat &format)

Establece el ` format` del objeto de texto.

Véase también format().

© 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.