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() 함수는 자식 프레임 목록을 제공합니다.
각 프레임은 텍스트 커서가 그 안에 새로운 문서 요소를 삽입할 수 있도록 최소 하나 이상의 텍스트 블록을 포함합니다. 따라서 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 스타일 이터레이터’ 문서를 참조하십시오.
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.
