QTextObjectInterface Class

Detaillierte Beschreibung

Ein Textobjekt beschreibt die Struktur eines oder mehrerer Elemente in einem Textdokument. So werden z.B. aus HTML importierte Bilder durch Textobjekte implementiert. Ein Textobjekt weiß, wie es seine Elemente anordnen und zeichnen muss, wenn ein Dokument gerendert wird.

Qt erlaubt das Einfügen von benutzerdefinierten Textobjekten in ein Dokument, indem ein benutzerdefiniertes object type mit QTextCharFormat registriert wird. Ein QTextObjectInterface muss auch für diesen Typ implementiert werden und registered mit dem QAbstractTextDocumentLayout des Dokuments sein. Wenn der Objekttyp beim Rendern eines QTextDocument angetroffen wird, 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 ein objectType. objectType ist eine Ganzzahl mit einem Wert größer oder gleich QTextFormat::UserObject.
• Erstellen Sie ein QTextCharFormat Objekt und setzen Sie den Objekttyp mit der Funktion setObjectType() auf den gewählten Typ.
• 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 der oben erwähnten QTextCharFormat des gewählten Objekttyps in das Dokument ein. Wie bereits erwähnt, werden dann die Funktionen von QTextObjectInterface intrinsicSize() und drawObject() mit QTextFormat als Parameter aufgerufen, sobald das Ersetzungszeichen auftritt.

Eine Klasse, die ein Textobjekt implementiert, muss sowohl QObject als auch QTextObjectInterface erben. QObject muss die erste geerbte Klasse sein. Ein Beispiel:

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

Die Daten eines Textobjekts werden normalerweise mit QTextCharFormat::setProperty() in QTextCharFormat gespeichert und dann mit QTextCharFormat::property() abgerufen.