QTextObjectInterface Class

Description détaillée

Un objet texte décrit la structure d'un ou plusieurs éléments dans un document texte ; par exemple, les images importées depuis du code HTML sont implémentées à l'aide d'objets texte. Un objet texte sait comment agencer et dessiner ses éléments lors du rendu d'un document.

Qt permet d’insérer des objets texte personnalisés dans un document en enregistrant une interface personnalisée ( object type ) via ` QTextCharFormat`. Une interface `QTextObjectInterface` doit également être implémentée pour ce type et être compatible ( registered ) avec l’interface de texte ( QAbstractTextDocumentLayout ) du document. Lorsque le type d’objet est rencontré lors du rendu d’un objet texte ( QTextDocument), les fonctions ` intrinsicSize()` et ` drawObject()` de l’interface sont appelées.

La liste suivante explique les étapes nécessaires à l’insertion d’un objet texte personnalisé dans un document :

• Choisissez un type d’ objectType. L’ objectType est un entier dont la valeur est supérieure ou égale à QTextFormat::UserObject.
• Créez un objet ` QTextCharFormat ` et définissez le type de l'objet sur le type choisi à l'aide de la fonction `setObjectType()`.
• Implémentez la classe QTextObjectInterface.
• Appelez la méthode ` QAbstractTextDocumentLayout::registerHandler()` avec une instance de votre sous-classe de `QTextObjectInterface` pour enregistrer votre type d’objet.
• Insérez ` QChar::ObjectReplacementCharacter ` avec l'QTextCharFormat, mentionnée précédemment, du type d'objet choisi dans le document. Comme indiqué, les fonctions de `QTextObjectInterface`, ` intrinsicSize()` et ` drawObject()`, seront alors appelées avec ` QTextFormat ` comme paramètre chaque fois qu'un caractère de remplacement sera rencontré.

Une classe implémentant un objet texte doit hériter à la fois de ` QObject ` et de `QTextObjectInterface`. ` QObject ` doit être la première classe héritée. Par exemple :

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

Les données d’un objet texte sont généralement stockées dans l’ QTextCharFormat à l’aide de QTextCharFormat::setProperty(), puis récupérées avec QTextCharFormat::property().