QTextObjectInterface Class

Descripción detallada

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

Qt permite insertar objetos de texto personalizados en un documento registrando un object type personalizado con QTextCharFormat. Una QTextObjectInterface también debe ser implementada para este tipo y ser registered con el QAbstractTextDocumentLayout del documento. Cuando se encuentra el tipo de objeto al renderizar un QTextDocument, se llama a 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:

• Elija un objeto objectType. El objectType es un número entero con un valor mayor o igual a QTextFormat::UserObject.
• Crear un objeto QTextCharFormat y establecer el tipo de objeto al tipo elegido mediante la función setObjectType().
• Implementar la clase QTextObjectInterface.
• Llame a QAbstractTextDocumentLayout::registerHandler() con una instancia de su subclase QTextObjectInterface para registrar su tipo de objeto.
• Inserta QChar::ObjectReplacementCharacter con la mencionada QTextCharFormat del tipo de objeto elegido en el documento. Como se ha mencionado, las funciones de QTextObjectInterface intrinsicSize() y drawObject() serán entonces llamadas con el QTextFormat como parámetro cada vez que se encuentre el caracter de reemplazo.

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

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

Los datos de un objeto de texto normalmente se almacenan en QTextCharFormat utilizando QTextCharFormat::setProperty(), y luego se recuperan con QTextCharFormat::property().