QPdfPageRenderer Class
QPdfPageRenderer 클래스는 PDF 문서의 페이지 렌더링을 캡슐화합니다. 더 보기...
| Header: | #include <QPdfPageRenderer> |
| Inherits: | QObject |
공용 유형
| enum class | RenderMode { MultiThreaded, SingleThreaded } |
속성
- document : QPdfDocument*
- renderMode : RenderMode
공공 기능
| QPdfPageRenderer(QObject *parent) | |
| virtual | ~QPdfPageRenderer() override |
| QPdfDocument * | document() const |
| QPdfPageRenderer::RenderMode | renderMode() const |
| quint64 | requestPage(int pageNumber, QSize imageSize, QPdfDocumentRenderOptions options = QPdfDocumentRenderOptions()) |
| void | setDocument(QPdfDocument *document) |
| void | setRenderMode(QPdfPageRenderer::RenderMode mode) |
신호
| void | documentChanged(QPdfDocument *document) |
| void | renderModeChanged(QPdfPageRenderer::RenderMode renderMode) |
상세 설명
QPdfPageRenderer에는 requestPage()를 통해 호출되는 모든 렌더링 요청을 수집하는 큐가 포함되어 있습니다. 설정된 RenderMode 에 따라 QPdfPageRenderer는 다음 이벤트 루프 호출(RenderMode::SingleThreaded) 또는 별도의 작업자 스레드(RenderMode::MultiThreaded)에서 이 큐를 처리하고 렌더링이 완료되면 각 요청에 대해 pageRendered() 신호를 통해 결과를 내보냅니다.
QPdfDocument 를참조하세요 .
멤버 유형 문서
enum class QPdfPageRenderer::RenderMode
이 열거형은 페이지가 렌더링되는 방식을 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QPdfPageRenderer::RenderMode::MultiThreaded | 0 | 모든 페이지가 별도의 작업자 스레드에서 렌더링됩니다. |
QPdfPageRenderer::RenderMode::SingleThreaded | 1 | 모든 페이지는 기본 UI 스레드에서 렌더링됩니다(기본값). |
renderMode() 및 setRenderMode()도 참조하세요 .
속성 문서
document : QPdfDocument*
이 속성은 이 객체가 페이지를 렌더링하는 문서 인스턴스를 보유합니다.
기본적으로 이 속성은 nullptr 입니다.
함수에 액세스합니다:
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
알림 신호:
| void | documentChanged(QPdfDocument *document) |
document(), setDocument() 및 QPdfDocument 를참조하세요 .
renderMode : RenderMode
이 속성은 렌더러가 페이지를 렌더링하는 데 사용하는 모드를 보유합니다.
기본적으로 이 속성은 RenderMode::SingleThreaded 입니다.
함수에 액세스합니다:
| QPdfPageRenderer::RenderMode | renderMode() const |
| void | setRenderMode(QPdfPageRenderer::RenderMode mode) |
알림 신호:
| void | renderModeChanged(QPdfPageRenderer::RenderMode renderMode) |
setRenderMode() 및 RenderMode 을참조하세요 .
멤버 함수 문서
[explicit] QPdfPageRenderer::QPdfPageRenderer(QObject *parent)
부모 객체가 있는 페이지 렌더러 객체를 parent 로 구성합니다.
[override virtual noexcept] QPdfPageRenderer::~QPdfPageRenderer()
페이지 렌더러 객체를 삭제합니다.
QPdfDocument *QPdfPageRenderer::document() const
이 객체가 페이지를 렌더링하는 문서를 반환하거나, 이전에 설정한 문서가 없는 경우 nullptr 을 반환합니다.
참고: 속성 문서에 대한 게터 함수입니다.
setDocument() 및 QPdfDocument 을참조하세요 .
QPdfPageRenderer::RenderMode QPdfPageRenderer::renderMode() const
페이지가 렌더링되는 방식을 반환합니다.
참고: 렌더모드 속성에 대한 게터 함수입니다.
setRenderMode() 및 RenderMode 을참조하세요 .
quint64 QPdfPageRenderer::requestPage(int pageNumber, QSize imageSize, QPdfDocumentRenderOptions options = QPdfDocumentRenderOptions())
제공된 options 에 따라 pageNumber 페이지를 imageSize 크기의 QImage 로 렌더링하도록 렌더러에 요청합니다.
렌더링이 완료되면 결과를 매개변수로 하여 pageRendered() 신호가 전송됩니다.
반환 값은 렌더링 요청을 고유하게 식별하는 ID입니다. 동일한 매개 변수를 가진 요청이 여전히 대기열에 있는 경우 대기열에 있는 요청의 ID가 반환됩니다.
void QPdfPageRenderer::setDocument(QPdfDocument *document)
이 객체가 페이지를 렌더링하는 document 을 설정합니다.
참고: document 속성에 대한 설정자 함수입니다.
document() 및 QPdfDocument도 참조하세요 .
void QPdfPageRenderer::setRenderMode(QPdfPageRenderer::RenderMode mode)
페이지가 렌더링되는 방식을 mode 로 설정합니다.
참고: renderMode 속성에 대한 세터 함수.
renderMode() 및 RenderMode도 참조하세요 .
© 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.
