En esta página

QTextBlockGroup Class

La clase `QTextBlockGroup` proporciona un contenedor para bloques de texto dentro de un ` QTextDocument`. Más...

Encabezado: #include <QTextBlockGroup>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QTextObject
Heredado por:

QTextList

Nota: Todas las funciones de esta clase son reentrantes.

Funciones protegidas

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)

Descripción detallada

Los grupos de bloques se pueden utilizar para organizar bloques de texto dentro de un documento. Mantienen una lista actualizada de los bloques de texto que les pertenecen, incluso cuando dichos bloques se están editando.

Cada grupo tiene un documento padre que se especifica al crear el grupo.

Los bloques de texto se pueden insertar en un grupo con ` blockInserted()` y eliminarse con ` blockRemoved()`. Si se modifica el formato de un bloque, se llama a ` blockFormatChanged()`.

La función ` blockList()` devuelve la lista de bloques del grupo. Tenga en cuenta que los bloques de la lista no son necesariamente elementos adyacentes en el documento; por ejemplo, los elementos de nivel superior de una lista de varios niveles estarán separados por los elementos de los niveles inferiores de la lista.

Véase también QTextBlock y QTextDocument.

Documentación de las funciones miembro

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

Crea un nuevo grupo de bloques para el document especificado.

Advertencia: Esta función solo debe invocarse desde QTextDocument::createObject().

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

Elimina este grupo de bloques; los bloques no se borran, simplemente dejan de pertenecer a este grupo.

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

Esta función se invoca cada vez que se modifica el « block » de texto especificado. El bloque de texto forma parte de este grupo.

La implementación de la clase base no realiza ninguna acción.

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

Añade el « block » indicado al final del grupo.

Advertencia: Si reimplementas esta función, debes llamar a la implementación de la clase base.

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

Devuelve una lista (que puede estar vacía) de todos los bloques que forman parte del grupo de bloques.

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

Elimina el « block » indicado del grupo; el bloque en sí no se elimina, simplemente deja de formar parte de este grupo.

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