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()로 찾을 수 있습니다.
프레임에는 setFormat()로 설정하고 format()로 읽을 수 있는 형식( QTextFrameFormat 로 지정)도 있습니다.
프레임 내에서 유효한 첫 번째 및 마지막 커서 위치를 가리키는 텍스트 커서를 얻을 수 있으며, 이를 위해 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()도 참조하세요 .
© 2025 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.
