Auf dieser Seite

QTextBlockGroup Class

Die Klasse „QTextBlockGroup“ stellt einen Container für Textblöcke innerhalb eines „ QTextDocument “ bereit. Mehr...

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

QTextList

Hinweis: Alle Funktionen dieser Klasse sind reentrant.

Geschützte Funktionen

QTextBlockGroup(QTextDocument *document)
virtual ~QTextBlockGroup()
virtual void blockFormatChanged(const QTextBlock &block)
virtual void blockInserted(const QTextBlock &block)
QList<QTextBlock> blockList() const
virtual void blockRemoved(const QTextBlock &block)

Ausführliche Beschreibung

Blockgruppen können verwendet werden, um Textblöcke innerhalb eines Dokuments zu organisieren. Sie führen eine aktuelle Liste der Textblöcke, die zu ihnen gehören, auch wenn Textblöcke gerade bearbeitet werden.

Jede Gruppe hat ein übergeordnetes Dokument, das beim Erstellen der Gruppe angegeben wird.

Textblöcke können mit ` blockInserted()` in eine Gruppe eingefügt und mit ` blockRemoved()` daraus entfernt werden. Wird das Format eines Blocks geändert, wird ` blockFormatChanged()` aufgerufen.

Die Liste der Blöcke in der Gruppe wird von ` blockList()` zurückgegeben. Beachten Sie, dass die Blöcke in der Liste nicht unbedingt benachbarte Elemente im Dokument sind; beispielsweise werden die Elemente der obersten Ebene in einer mehrstufigen Liste durch die Elemente auf den unteren Ebenen der Liste getrennt.

Siehe auch QTextBlock und QTextDocument.

Dokumentation zu den Mitgliedsfunktionen

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

Erstellt eine neue Blockgruppe für die angegebene „ document “.

Warnung: Diese Funktion sollte nur aus QTextDocument::createObject() aufgerufen werden.

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

Löscht diese Blockgruppe; die Blöcke werden nicht gelöscht, sie gehören lediglich nicht mehr zu dieser Gruppe.

[virtual protected] void QTextBlockGroup::blockFormatChanged(const QTextBlock &block)

Diese Funktion wird immer dann aufgerufen, wenn sich der angegebene Text block t ändert. Der Textblock ist ein Element dieser Gruppe.

Die Implementierung der Basisklasse führt keine Aktion aus.

[virtual protected] void QTextBlockGroup::blockInserted(const QTextBlock &block)

Fügt die angegebene „ block “ am Ende der Gruppe an.

Warnung: Wenn Sie diese Funktion neu implementieren, müssen Sie die Implementierung der Basisklasse aufrufen.

[protected] QList<QTextBlock> QTextBlockGroup::blockList() const

Gibt eine (möglicherweise leere) Liste aller Blöcke zurück, die Teil der Blockgruppe sind.

[virtual protected] void QTextBlockGroup::blockRemoved(const QTextBlock &block)

Entfernt den angegebenen Block „ block “ aus der Gruppe; der Block selbst wird nicht gelöscht, er gehört lediglich nicht mehr zu dieser Gruppe.

© 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.