QPdfPageRenderer Class
Die Klasse QPdfPageRenderer kapselt das Rendering von Seiten eines PDF-Dokuments. Mehr...
| Header: | #include <QPdfPageRenderer> |
| Inherits: | QObject |
Öffentliche Typen
| enum class | RenderMode { MultiThreaded, SingleThreaded } |
Eigenschaften
- document : QPdfDocument*
- renderMode : RenderMode
Öffentliche Funktionen
| 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) |
Signale
| void | documentChanged(QPdfDocument *document) |
| void | renderModeChanged(QPdfPageRenderer::RenderMode renderMode) |
Detaillierte Beschreibung
Der QPdfPageRenderer enthält eine Warteschlange, die alle Renderanfragen sammelt, die über requestPage() aufgerufen werden. Abhängig von der Konfiguration RenderMode verarbeitet der QPdfPageRenderer diese Warteschlange im Haupt-UI-Thread beim nächsten Aufruf der Ereignisschleife (RenderMode::SingleThreaded) oder in einem separaten Worker-Thread (RenderMode::MultiThreaded) und gibt das Ergebnis über das pageRendered()-Signal für jede Anfrage aus, sobald das Rendering abgeschlossen ist.
Siehe auch QPdfDocument.
Dokumentation der Mitgliedstypen
enum class QPdfPageRenderer::RenderMode
Diese Aufzählung beschreibt, wie die Seiten gerendert werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPdfPageRenderer::RenderMode::MultiThreaded | 0 | Alle Seiten werden in einem separaten Worker-Thread gerendert. |
QPdfPageRenderer::RenderMode::SingleThreaded | 1 | Alle Seiten werden im Haupt-UI-Thread gerendert (Standard). |
Siehe auch renderMode() und setRenderMode().
Eigenschaft Dokumentation
document : QPdfDocument*
Diese Eigenschaft enthält die Dokumentinstanz, aus der das Objekt die Seiten rendert.
Standardmäßig ist diese Eigenschaft nullptr.
Zugriffsfunktionen:
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
Benachrichtigungssignal:
| void | documentChanged(QPdfDocument *document) |
Siehe auch document(), setDocument(), und QPdfDocument.
renderMode : RenderMode
Diese Eigenschaft enthält den Modus, den der Renderer zum Rendern der Seiten verwendet.
Standardmäßig ist diese Eigenschaft RenderMode::SingleThreaded.
Zugriffsfunktionen:
| QPdfPageRenderer::RenderMode | renderMode() const |
| void | setRenderMode(QPdfPageRenderer::RenderMode mode) |
Benachrichtigungssignal:
| void | renderModeChanged(QPdfPageRenderer::RenderMode renderMode) |
Siehe auch setRenderMode() und RenderMode.
Dokumentation der Mitgliedsfunktionen
[explicit] QPdfPageRenderer::QPdfPageRenderer(QObject *parent)
Konstruiert ein Seitenrenderer-Objekt mit dem übergeordneten Objekt parent.
[override virtual noexcept] QPdfPageRenderer::~QPdfPageRenderer()
Zerstört das Seitenrenderer-Objekt.
QPdfDocument *QPdfPageRenderer::document() const
Gibt das Dokument zurück, aus dem dieses Objekt die Seiten rendert, oder ein nullptr, wenn zuvor keines festgelegt wurde.
Hinweis: Getter-Funktion für die Eigenschaft document.
Siehe auch setDocument() und QPdfDocument.
QPdfPageRenderer::RenderMode QPdfPageRenderer::renderMode() const
Gibt den Modus zurück, in dem die Seiten gerendert werden.
Hinweis: Getter-Funktion für die Eigenschaft renderMode.
Siehe auch setRenderMode() und RenderMode.
quint64 QPdfPageRenderer::requestPage(int pageNumber, QSize imageSize, QPdfDocumentRenderOptions options = QPdfDocumentRenderOptions())
Fordert den Renderer auf, die Seite pageNumber in eine QImage der Größe imageSize entsprechend der angegebenen options zu rendern.
Sobald das Rendering abgeschlossen ist, wird das Signal pageRendered() mit dem Ergebnis als Parameter ausgegeben.
Der Rückgabewert ist eine ID, die die Renderanfrage eindeutig identifiziert. Befindet sich eine Anforderung mit denselben Parametern noch in der Warteschlange, wird die ID dieser Anforderung zurückgegeben.
void QPdfPageRenderer::setDocument(QPdfDocument *document)
Legt die document fest, von der aus dieses Objekt die Seiten rendert.
Hinweis: Setter-Funktion für die Eigenschaft document.
Siehe auch document() und QPdfDocument.
void QPdfPageRenderer::setRenderMode(QPdfPageRenderer::RenderMode mode)
Setzt den Modus, wie die Seiten gerendert werden, auf mode.
Hinweis: Setter-Funktion für die Eigenschaft renderMode.
Siehe auch renderMode() und 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.
