QTextObjectInterface Class

Ausführliche Beschreibung

Ein Textobjekt beschreibt die Struktur eines oder mehrerer Elemente in einem Textdokument; beispielsweise werden aus HTML importierte Bilder mithilfe von Textobjekten implementiert. Ein Textobjekt weiß, wie seine Elemente beim Rendern eines Dokuments angeordnet und gezeichnet werden müssen.

Qt ermöglicht das Einfügen benutzerdefinierter Textobjekte in ein Dokument, indem eine benutzerdefinierte Schnittstelle ` object type ` mit ` QTextCharFormat` registriert wird. Für diesen Typ muss außerdem eine `QTextObjectInterface` implementiert sein, die mit der Schnittstelle ` QAbstractTextDocumentLayout ` des Dokuments ` registered ` ist. Wenn der Objekttyp beim Rendern eines ` QTextDocument` auftritt, werden die Funktionen ` intrinsicSize()` und ` drawObject()` der Schnittstelle aufgerufen.

Die folgende Liste erläutert die erforderlichen Schritte zum Einfügen eines benutzerdefinierten Textobjekts in ein Dokument:

• Wählen Sie einen „ objectType “ aus. Der „ objectType “ ist eine Ganzzahl mit einem Wert größer oder gleich „ QTextFormat::UserObject “.
• Erstellen Sie ein „ QTextCharFormat “-Objekt und legen Sie den Objekttyp mithilfe der Funktion „setObjectType()“ auf den gewählten Typ fest.
• Implementieren Sie die Klasse `QTextObjectInterface`.
• Rufen Sie ` QAbstractTextDocumentLayout::registerHandler()` mit einer Instanz Ihrer `QTextObjectInterface`-Unterklasse auf, um Ihren Objekttyp zu registrieren.
• Fügen Sie ` QChar::ObjectReplacementCharacter ` mit dem zuvor erwähnten ` QTextCharFormat ` des gewählten Objekttyps in das Dokument ein. Wie bereits erwähnt, werden die Funktionen von `QTextObjectInterface`, nämlich ` intrinsicSize()` und ` drawObject()`, dann jedes Mal mit dem ` QTextFormat ` als Parameter aufgerufen, wenn das Ersetzungszeichen auftritt.

Eine Klasse, die ein Textobjekt implementiert, muss sowohl von ` QObject ` als auch von `QTextObjectInterface` erben. ` QObject ` muss die erste Klasse sein, von der geerbt wird. Zum Beispiel:

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

Die Daten eines Textobjekts werden in der Regel mithilfe von ` QTextCharFormat::setProperty()` in ` QTextCharFormat ` gespeichert und anschließend mit ` QTextCharFormat::property()` abgerufen.