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 はこのキューを次のイベントループの呼び出し時にメイン UI スレッド (RenderMode::SingleThreaded) あるいは別のワーカースレッド (RenderMode::MultiThreaded) で処理し、レンダリングが完了すると各リクエストの pageRendered() シグナルで結果を返します。
QPdfDocumentも参照してください 。
メンバ型ドキュメント
enum class QPdfPageRenderer::RenderMode
この列挙型は、ページがどのようにレンダリングされるかを記述します。
| 定数 | 値 | 説明 |
|---|---|---|
QPdfPageRenderer::RenderMode::MultiThreaded | 0 | すべてのページは別のワーカースレッドでレンダリングされます。 |
QPdfPageRenderer::RenderMode::SingleThreaded | 1 | すべてのページはメイン UI スレッドでレンダリングされます (デフォルト)。 |
renderMode() およびsetRenderMode()も参照してください 。
プロパティ ドキュメント
document : QPdfDocument*
このプロパティは、このオブジェクトがページをレンダリングするドキュメントインスタンスを保持します。
デフォルトでは、このプロパティはnullptr です。
アクセス関数：
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
Notifier シグナル：
| 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 を返します。
注意： プロパティ document のゲッター関数です。
setDocument() およびQPdfDocumentも参照してください 。
QPdfPageRenderer::RenderMode QPdfPageRenderer::renderMode() const
ページがどのようにレンダリングされるかのモードを返す。
注： プロパティ renderMode のゲッター関数です。
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.
