Auf dieser Seite

QTextObject Class

Die Klasse „QTextObject“ ist eine Basisklasse für verschiedene Arten von Objekten, die Teile eines „ QTextDocument “ zusammenfassen können. Mehr dazu...

Header: #include <QTextObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Erbt von: QObject
Vererbt an:

QTextBlockGroup und QTextFrame

Hinweis: Alle Funktionen dieser Klasse sind reentrant.

Öffentliche Funktionen

QTextDocument *document() const
QTextFormat format() const
int formatIndex() const
int objectIndex() const

Geschützte Funktionen

QTextObject(QTextDocument *document)
virtual ~QTextObject()
void setFormat(const QTextFormat &format)

Ausführliche Beschreibung

Die gängigen Gruppen von Textobjekten sind Listen (QTextList), Rahmen (QTextFrame) und Tabellen (QTextTable). Einem Textobjekt sind jeweils die Methoden „ format()“ und „ document()“ zugeordnet.

Es gibt im Wesentlichen zwei Arten von Textobjekten: solche, die mit Blöcken (Blockformate) verwendet werden, und solche, die mit Zeichen (Zeichenformate) verwendet werden. Die erste Art leitet sich von ` QTextBlockGroup` ab, die zweite von ` QTextFrame`.

Sie müssen diese Klasse nur selten direkt verwenden. Beim Erstellen benutzerdefinierter Textobjekte müssen Sie außerdem ` QTextDocument::createObject()` neu implementieren, das als Factory-Methode zum Erstellen von Textobjekten dient.

Siehe auch QTextDocument.

Dokumentation zu den Mitgliedsfunktionen

[explicit protected] QTextObject::QTextObject(QTextDocument *document)

Erstellt ein neues QTextObject für das angegebene ` document`.

Warnung: Diese Funktion sollte niemals direkt aufgerufen werden, sondern nur über ` QTextDocument::createObject()` .

[virtual noexcept protected] QTextObject::~QTextObject()

Löscht das Textobjekt.

Warnung: Textobjekte gehören zum Dokument, daher sollten Sie sie niemals selbst löschen.

QTextDocument *QTextObject::document() const

Gibt das Dokument zurück, zu dem dieses Objekt gehört.

Siehe auch ` format()`.

QTextFormat QTextObject::format() const

Gibt das Format des Textobjekts zurück.

Siehe auch setFormat() und document().

int QTextObject::formatIndex() const

Gibt den Index des Formats des Objekts in der internen Formatliste des Dokuments zurück.

Siehe auch „ QTextDocument::allFormats()“.

int QTextObject::objectIndex() const

Gibt den Objektindex dieses Objekts zurück. Dies kann in Verbindung mit ` QTextFormat::setObjectIndex()` verwendet werden.

[protected] void QTextObject::setFormat(const QTextFormat &format)

Legt die „ format “ des Textobjekts fest.

Siehe auch ` format()`.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.