QTextObjectInterface Class

Description détaillée

Un objet texte décrit la structure d'un ou de plusieurs éléments dans un document texte ; par exemple, les images importées de HTML sont implémentées à l'aide d'objets texte. Un objet texte sait comment disposer 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 un object type personnalisé auprès de QTextCharFormat. Une interface QTextObjectInterface doit également être implémentée pour ce type et être registered avec le QAbstractTextDocumentLayout du document. Lorsque le type d'objet est rencontré lors du rendu d'un document 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 objet objectType. objectType est un entier dont la valeur est supérieure ou égale à QTextFormat::UserObject.
• Créer un objet QTextCharFormat et définir le type d'objet au type choisi à l'aide de la fonction setObjectType().
• Implémentez la classe QTextObjectInterface.
• Appelez QAbstractTextDocumentLayout::registerHandler() avec une instance de votre sous-classe QTextObjectInterface pour enregistrer votre type d'objet.
• Insérer dans le document QChar::ObjectReplacementCharacter avec le QTextCharFormat susmentionné le type d'objet choisi. Comme indiqué, les fonctions de QTextObjectInterface intrinsicSize() et drawObject() seront alors appelées avec QTextFormat comme paramètre chaque fois que le 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 QTextCharFormat à l'aide de QTextCharFormat::setProperty(), puis récupérées à l'aide de QTextCharFormat::property().