Sur cette page

QTextBlockGroup Class

La classe `QTextBlockGroup` fournit un conteneur pour les blocs de texte au sein d'un ` QTextDocument`. En savoir plus...

En-tête : #include <QTextBlockGroup>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Hérite de : QTextObject
Hérité par :

QTextList

Remarque : toutes les fonctions de cette classe sont réentrantes.

Fonctions protégées

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)

Description détaillée

Les groupes de blocs permettent d'organiser des blocs de texte au sein d'un document. Ils tiennent à jour la liste des blocs de texte qui leur appartiennent, même lorsque ces derniers sont en cours d'édition.

Chaque groupe possède un document parent qui est spécifié lors de la création du groupe.

Les blocs de texte peuvent être insérés dans un groupe à l’aide de la fonction ` blockInserted()` et supprimés à l’aide de ` blockRemoved()`. Si le format d’un bloc est modifié, la fonction ` blockFormatChanged()` est appelée.

La liste des blocs du groupe est renvoyée par la fonction blockList(). Notez que les blocs de la liste ne sont pas nécessairement des éléments adjacents dans le document ; par exemple, les éléments de niveau supérieur d’une liste à plusieurs niveaux seront séparés par les éléments des niveaux inférieurs de la liste.

Voir également QTextBlock et QTextDocument.

Documentation des fonctions membres

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

Crée un nouveau groupe de blocs pour l'document donné.

Avertissement : cette fonction ne doit être appelée qu'à partir de ` QTextDocument::createObject()` .

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

Supprime ce groupe de blocs ; les blocs ne sont pas supprimés, ils n'appartiennent simplement plus à ce groupe.

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

Cette fonction est appelée chaque fois que l'block e spécifiée du texte est modifiée. Le bloc de texte fait partie de ce groupe.

L'implémentation de la classe par défaut ne fait rien.

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

Ajoute l'block on indiquée à la fin du groupe.

Avertissement : si vous réimplémentez cette fonction, vous devez appeler l'implémentation de la classe parente.

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

Renvoie une liste (éventuellement vide) de tous les blocs faisant partie du groupe de blocs.

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

Supprime l'block on indiquée du groupe ; le bloc lui-même n'est pas supprimé, il ne fait simplement plus partie de ce groupe.

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