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:
- Elige un ` objectType`. El ` objectType ` es un entero con un valor mayor o igual que ` QTextFormat::UserObject`.
- Crea un objeto ` QTextCharFormat ` y establece el tipo del objeto en el tipo elegido mediante la función `setObjectType()`.
- Implementa la clase QTextObjectInterface.
- Llama a ` QAbstractTextDocumentLayout::registerHandler()` con una instancia de tu subclase de `QTextObjectInterface` para registrar tu tipo de objeto.
- Inserta ` QChar::ObjectReplacementCharacter ` con el ` QTextCharFormat ` mencionado anteriormente del tipo de objeto elegido en el documento. Como se ha mencionado, las funciones de `QTextObjectInterface` ` intrinsicSize()` y ` drawObject()` se llamarán entonces con ` QTextFormat ` como parámetro cada vez que se encuentre el carácter de sustitución.
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.