QTextFrame Class
QTextFrame クラスは、QTextDocument 内のフレームを表します。詳細...
| ヘッダー: | #include <QTextFrame> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 継承元: | QTextObject |
| 継承元: |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QTextFrame は、リッチテキスト処理 API の一部です。
注：このクラスのすべての関数は再入可能です。
パブリック型
パブリック関数
| QTextFrame(QTextDocument *document) | |
| virtual | ~QTextFrame() |
| QTextFrame::iterator | begin() const |
| QList<QTextFrame *> | childFrames() const |
| QTextFrame::iterator | end() const |
| QTextCursor | firstCursorPosition() const |
| int | firstPosition() const |
| QTextFrameFormat | frameFormat() const |
| QTextCursor | lastCursorPosition() const |
| int | lastPosition() const |
| QTextFrame * | parentFrame() const |
| void | setFrameFormat(const QTextFrameFormat &format) |
詳細な説明
テキストフレームは、ドキュメント内のテキストに構造を与えます。これらは、他のドキュメント要素の汎用コンテナとして使用されます。フレームは通常、QTextCursor::insertFrame() を使用して作成されます。
フレームを使用すると、リッチテキスト文書内で階層構造を作成できます。各文書にはルートフレーム（QTextDocument::rootFrame()）があり、ルートフレームの下にある各フレームには親フレームと（空の場合もある）子フレームのリストがあります。親フレームはparentFrame()で取得でき、childFrames()関数は子フレームのリストを提供します。
各フレームには、テキストカーソルが新しいドキュメント要素を挿入できるようにするためのテキストブロックが少なくとも1つ含まれています。その結果、QTextFrame::iterator クラスは、特定のフレーム内のブロックと子フレームの両方を走査するために使用されます。フレーム内の最初の子要素と最後の子要素は、begin()およびend()を使用して取得できます。
また、フレームには（QTextFrameFormat を使用して指定される）フォーマットがあり、これはsetFormat() で設定し、format() で取得できます。
フレーム内の最初の有効なカーソル位置と最後の有効なカーソル位置を指すテキストカーソルを取得できます。これには、firstCursorPosition() およびlastCursorPosition() 関数を使用します。ドキュメント内でのフレームの範囲は、firstPosition() およびlastPosition() で確認できます。
QTextFrame::iterator クラスを使用すると、フレームの内容を反復処理できます。このクラスは、テキストブロックや子フレームの内部リストへの読み取り専用アクセスを提供します。
QTextCursor およびQTextDocumentも参照してください 。
メンバ関数のドキュメント
[explicit] QTextFrame::QTextFrame(QTextDocument *document)
「document 」というテキスト用の新しい空のフレームを作成します。
[virtual noexcept] QTextFrame::~QTextFrame()
テキストフレームを削除します。
警告：テキスト フレームは ドキュメントに属しているため、ユーザー自身が削除してはなりません。ドキュメントからフレームを削除するには、QTextCursor を使用してその内容を削除してください。
QTextFrame::iterator QTextFrame::begin() const
フレーム内の最初のドキュメント要素を指すイテレータを返します。詳細については、ドキュメント「STL-style-Iterators」を参照してください。
end()も参照してください 。
QList<QTextFrame *> QTextFrame::childFrames() const
そのフレームの子フレームのリスト（空の場合もある）を返します。
parentFrame()も参照してください 。
QTextFrame::iterator QTextFrame::end() const
フレーム内の最後のドキュメント要素の直後の位置を指すイテレータを返します。詳細については、ドキュメント「STL スタイルのイテレータ」を参照してください。
begin()も参照してください 。
QTextCursor QTextFrame::firstCursorPosition() const
フレーム内の最初のカーソル位置を返します。
lastCursorPosition()、firstPosition()、およびlastPosition()も参照してください 。
int QTextFrame::firstPosition() const
フレーム内の最初のドキュメントの位置を返します。
lastPosition()、firstCursorPosition()、およびlastCursorPosition()も参照してください 。
QTextFrameFormat QTextFrame::frameFormat() const
フレームのフォーマットを返します。
setFrameFormat()も参照してください 。
QTextCursor QTextFrame::lastCursorPosition() const
フレーム内の最後のカーソル位置を返します。
firstCursorPosition()、firstPosition()、およびlastPosition()も参照してください 。
int QTextFrame::lastPosition() const
フレーム内の最後のドキュメント位置を返します。
firstPosition()、firstCursorPosition()、およびlastCursorPosition()も参照してください 。
QTextFrame *QTextFrame::parentFrame() const
フレームの親フレームを返します。そのフレームがドキュメントのルートフレームである場合、0 が返されます。
childFrames() およびQTextDocument::rootFrame()も参照してください 。
void QTextFrame::setFrameFormat(const QTextFrameFormat &format)
フレームのformat を設定します。
frameFormat()も参照してください 。
© 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.
