このページでは

QTextBlockGroup Class

QTextBlockGroup クラスは、QTextDocument 内のテキストブロックを格納するためのコンテナを提供します。詳細...

ヘッダー: #include <QTextBlockGroup>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
継承元: QTextObject
継承元:

QTextList

注:このクラスのすべての関数は再入可能です。

保護された関数

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)

詳細な説明

ブロックグループは、ドキュメント内のテキストブロックを整理するために使用できます。テキストブロックが編集中であっても、ブロックグループは、そのグループに属するテキストブロックの最新リストを維持します。

各グループには親ドキュメントがあり、グループの構築時に指定されます。

テキストブロックは、blockInserted() を使用してグループに挿入し、blockRemoved() を使用してグループから削除することができます。ブロックのフォーマットが変更された場合、blockFormatChanged() が呼び出されます。

グループ内のブロックのリストは、blockList() によって返されます。リスト内のブロックは、必ずしもドキュメント内で隣接する要素であるとは限らないことに注意してください。たとえば、多階層リストの最上位の項目は、リストの下位レベルの項目によって隔てられることになります。

QTextBlock およびQTextDocumentも参照してください 。

メンバ関数のドキュメント

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

指定されたdocument に対して、新しいブロックグループを作成します。

警告: この関数は 、QTextDocument::createObject() からのみ呼び出す必要があります。

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

このブロックグループを削除します。ブロック自体は削除されず、単にこのブロックグループに属さなくなるだけです。

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

この関数は、指定されたテキストのblock が変更されるたびに呼び出されます。このテキストブロックは、このグループのメンバーです。

基底クラスの実装では何も行われません。

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

指定されたblock をグループの末尾に追加します。

警告:この関数を再実装する場合は 、基底クラスの実装を呼び出す必要があります。

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

そのブロックグループを構成するすべてのブロック(空の場合もある)のリストを返します。

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

指定されたblock をグループから削除します。ブロック自体は削除されず、単にこのグループのメンバーではなくなります。

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