En esta página

QTextObjectInterface Class

La clase `QTextObjectInterface` permite dibujar objetos de texto personalizados en ` QTextDocument`. Más información...

Encabezado: #include <QTextObjectInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Funciones públicas

virtual ~QTextObjectInterface()
virtual void drawObject(QPainter *painter, const QRectF &rect, QTextDocument *doc, int posInDocument, const QTextFormat &format) = 0
virtual QSizeF intrinsicSize(QTextDocument *doc, int posInDocument, const QTextFormat &format) = 0

Descripción detallada

Un objeto de texto describe la estructura de uno o más elementos de un documento de texto; por ejemplo, las imágenes importadas desde HTML se implementan mediante objetos de texto. Un objeto de texto sabe cómo distribuir y dibujar sus elementos cuando se representa un documento.

Qt permite insertar objetos de texto personalizados en un documento registrando una interfaz de objeto de texto personalizada ( object type ) con ` QTextCharFormat`. También debe implementarse una interfaz `QTextObjectInterface` para este tipo y ser compatible ( registered ) con la interfaz de objeto de texto ( QAbstractTextDocumentLayout ) del documento. Cuando se encuentra el tipo de objeto durante la representación de un objeto de texto ( QTextDocument), se invocan las funciones ` intrinsicSize()` y ` drawObject()` de la interfaz.

La siguiente lista explica los pasos necesarios para insertar un objeto de texto personalizado en un documento:

Una clase que implemente un objeto de texto debe heredar tanto de QObject como de QTextObjectInterface. QObject debe ser la primera clase de la que se herede. Por ejemplo:

class SvgTextObject : public QObject, public QTextObjectInterface
{
    Q_OBJECT
    Q_INTERFACES(QTextObjectInterface)

Los datos de un objeto de texto suelen almacenarse en QTextCharFormat mediante QTextCharFormat::setProperty(), y luego se recuperan con QTextCharFormat::property().

Advertencia: Las operacionesde copiar y pegar ignoran los objetos de texto personalizados.

Véase también « QTextCharFormat » y « QTextLayout ».

Documentación de funciones de miembro

[virtual noexcept] QTextObjectInterface::~QTextObjectInterface()

Elimina esto: QTextObjectInterface.

[pure virtual] void QTextObjectInterface::drawObject(QPainter *painter, const QRectF &rect, QTextDocument *doc, int posInDocument, const QTextFormat &format)

Dibuja este objeto de texto utilizando el painter especificado.

El tamaño del rectángulo, ` rect`, en el que se va a dibujar es el tamaño calculado previamente por ` intrinsicSize()`. La posición del rectángulo es relativa al ` painter`.

También se obtienen el documento (doc) y la posición (posInDocument) del format en dicho documento.

Véase también intrinsicSize().

[pure virtual] QSizeF QTextObjectInterface::intrinsicSize(QTextDocument *doc, int posInDocument, const QTextFormat &format)

La función `intrinsicSize()` devuelve el tamaño del objeto de texto representado por ` format ` en el documento indicado (`doc`) en la posición indicada (`posInDocument`).

El tamaño calculado se utilizará en las llamadas posteriores a ` drawObject()` para este ` format`.

Véase también drawObject().

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