QPrintPreviewWidget Class
Die Klasse „QPrintPreviewWidget“ stellt ein Widget zur Vorschau von Seitenlayouts für die Druckausgabe bereit. Mehr...
| Kopfzeile: | #include <QPrintPreviewWidget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| Erbt von: | QWidget |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPrintPreviewWidget ist Teil der Drucker- und Druck-APIs.
Öffentliche Typen
| enum | ViewMode { SinglePageView, FacingPagesView, AllPagesView } |
| enum | ZoomMode { CustomZoom, FitToWidth, FitInView } |
Öffentliche Funktionen
| QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| virtual | ~QPrintPreviewWidget() |
| int | currentPage() const |
| QPageLayout::Orientation | orientation() const |
| int | pageCount() const |
| QPrintPreviewWidget::ViewMode | viewMode() const |
| qreal | zoomFactor() const |
| QPrintPreviewWidget::ZoomMode | zoomMode() const |
Neu implementierte öffentliche Funktionen
| virtual void | setVisible(bool visible) override |
Öffentliche Slots
| void | fitInView() |
| void | fitToWidth() |
| void | print() |
| void | setAllPagesViewMode() |
| void | setCurrentPage(int page) |
| void | setFacingPagesViewMode() |
| void | setLandscapeOrientation() |
| void | setOrientation(QPageLayout::Orientation orientation) |
| void | setPortraitOrientation() |
| void | setSinglePageViewMode() |
| void | setViewMode(QPrintPreviewWidget::ViewMode mode) |
| void | setZoomFactor(qreal factor) |
| void | setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode) |
| void | updatePreview() |
| void | zoomIn(qreal factor = 1.1) |
| void | zoomOut(qreal factor = 1.1) |
Signale
| void | paintRequested(QPrinter *printer) |
| void | previewChanged() |
Ausführliche Beschreibung
QPrintPreviewDialog verwendet intern ein `QPrintPreviewWidget`, und der Zweck von `QPrintPreviewWidget` besteht darin, die Einbettung der Vorschau in andere Widgets zu ermöglichen. Außerdem ermöglicht es, eine andere Benutzeroberfläche darum herum zu erstellen als die Standardoberfläche, die mit ` QPrintPreviewDialog` bereitgestellt wird.
Die Verwendung von `QPrintPreviewWidget` ist unkompliziert:
- Erstellen Sie das `QPrintPreviewWidget`
Erstellen Sie das `QPrintPreviewWidget`, indem Sie entweder ein vorhandenes ` QPrinter `-Objekt übergeben oder das `QPrintPreviewWidget` ein standardmäßig initialisiertes ` QPrinter `-Objekt für Sie erstellen lassen.
- Verbinden Sie das Signal ` paintRequested()` mit einem Slot.
Wenn das Widget eine Reihe von Vorschauseiten generieren muss, wird vom Widget das Signal „ paintRequested()“ ausgesendet. Verbinden Sie einen Slot mit diesem Signal und zeichnen Sie auf das als Signalparameter übergebene „ QPrinter “. Rufen Sie „ QPrinter::newPage()“ auf, um eine neue Seite in der Vorschau zu starten.
Siehe auch „ QPrinter“ , „ QPrintDialog “, „ QPageSetupDialog “ und „ QPrintPreviewDialog “.
Dokumentation zu Mitgliedstypen
enum QPrintPreviewWidget::ViewMode
Diese Enumeration dient zur Beschreibung des Anzeigemodus des Vorschau-Widgets.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | Ein Modus, in dem einzelne Seiten in der Vorschau angezeigt werden. |
QPrintPreviewWidget::FacingPagesView | 1 | Ein Modus, in dem die gegenüberliegenden Seiten in der Vorschau angezeigt werden. |
QPrintPreviewWidget::AllPagesView | 2 | Ein Anzeigemodus, in dem alle Seiten der Vorschau angezeigt werden. |
enum QPrintPreviewWidget::ZoomMode
Diese Enumeration dient zur Beschreibung des Zoom-Modus des Vorschau-Widgets.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | Der Zoom wird auf einen benutzerdefinierten Zoomwert eingestellt. |
QPrintPreviewWidget::FitToWidth | 1 | In diesem Modus wird die aktuelle Seite an die Breite der Ansicht angepasst. |
QPrintPreviewWidget::FitInView | 2 | In diesem Modus wird die aktuelle Seite innerhalb der Ansicht angepasst. |
Dokumentation der Mitgliedsfunktionen
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Erstellt ein `QPrintPreviewWidget` auf Basis von ` printer ` und mit ` parent ` als übergeordnetem Widget. Die Widget-Flags ` flags ` werden an den Konstruktor von ` QWidget ` übergeben.
Siehe auch QWidget::setWindowFlags().
[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Dadurch erstellt „QPrintPreviewWidget“ ein internes, standardmäßig initialisiertes „ QPrinter “-Objekt, das zur Erzeugung der Vorschau verwendet wird.
Dies ist eine überladene Funktion.
[virtual noexcept] QPrintPreviewWidget::~QPrintPreviewWidget()
Zerstört die „ QPrintPreviewWidget “.
int QPrintPreviewWidget::currentPage() const
Gibt die aktuell angezeigte Seite in der Vorschau zurück.
Siehe auch „ setCurrentPage()“.
[slot] void QPrintPreviewWidget::fitInView()
Dies ist eine Hilfsfunktion, die dem Aufruf von „ setZoomMode(QPrintPreviewWidget::FitInView) “ entspricht.
[slot] void QPrintPreviewWidget::fitToWidth()
Dies ist eine Hilfsfunktion, die dem Aufruf von ` setZoomMode(QPrintPreviewWidget::FitToWidth)` entspricht.
QPageLayout::Orientation QPrintPreviewWidget::orientation() const
Gibt die aktuelle Ausrichtung der Vorschau zurück. Dieser Wert wird aus dem mit der Vorschau verknüpften „ QPrinter “-Objekt abgerufen.
Siehe auch ` setOrientation()`.
int QPrintPreviewWidget::pageCount() const
Gibt die Anzahl der Seiten in der Vorschau zurück.
[signal] void QPrintPreviewWidget::paintRequested(QPrinter *printer)
Dieses Signal wird ausgelöst, wenn das Vorschau-Widget eine Reihe von Vorschauseiten erstellen muss. „ printer “ ist der Drucker, der diesem Vorschau-Widget zugeordnet ist.
[signal] void QPrintPreviewWidget::previewChanged()
Dieses Signal wird immer dann ausgelöst, wenn das Vorschau-Widget einen internen Zustand geändert hat, beispielsweise die Ausrichtung.
[slot] void QPrintPreviewWidget::print()
Druckt die Vorschau auf dem Drucker aus, der der Vorschau zugeordnet ist.
[slot] void QPrintPreviewWidget::setAllPagesViewMode()
Dies ist eine Hilfsfunktion, die dem Aufruf von „ setViewMode(QPrintPreviewWidget::AllPagesView) “ entspricht.
[slot] void QPrintPreviewWidget::setCurrentPage(int page)
Setzt die aktuelle Seite in der Vorschau. Dadurch springt die Ansicht an den Anfang von page.
Siehe auch currentPage().
[slot] void QPrintPreviewWidget::setFacingPagesViewMode()
Dies ist eine Hilfsfunktion, die dem Aufruf von „ setViewMode(QPrintPreviewWidget::FacingPagesView) “ entspricht.
[slot] void QPrintPreviewWidget::setLandscapeOrientation()
Dies ist eine Hilfsfunktion, die dem Aufruf von ` setOrientation(QPageLayout::Landscape)` entspricht.
[slot] void QPrintPreviewWidget::setOrientation(QPageLayout::Orientation orientation)
Setzt die aktuelle Ausrichtung auf „ orientation “. Dieser Wert wird für das mit der Vorschau verknüpfte „ QPrinter “-Objekt festgelegt.
Siehe auch ` orientation()`.
[slot] void QPrintPreviewWidget::setPortraitOrientation()
Dies ist eine Hilfsfunktion, die dem Aufruf von „ setOrientation(QPageLayout::Portrait) “ entspricht.
[slot] void QPrintPreviewWidget::setSinglePageViewMode()
Dies ist eine Hilfsfunktion, die dem Aufruf von ` setViewMode(QPrintPreviewWidget::SinglePageView)` entspricht.
[slot] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)
Stellt den Anzeigemodus auf „ mode “ ein. Der Standardanzeigemodus ist „ SinglePageView “.
Siehe auch „ viewMode()“.
[override virtual] void QPrintPreviewWidget::setVisible(bool visible)
[slot] void QPrintPreviewWidget::setZoomFactor(qreal factor)
Legt den Zoomfaktor der Ansicht auf factor fest. Ein Wert von 1,0 steht beispielsweise für eine nicht skalierte Ansicht, deren Größe in etwa der Größe auf Papier entspricht. Ein Wert von 0,5 halbiert die Größe der Ansicht, während ein Wert von 2,0 die Größe der Ansicht verdoppelt.
Siehe auch ` zoomFactor()`.
[slot] void QPrintPreviewWidget::setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)
Stellt den Zoom-Modus auf „ zoomMode “ ein. Der Standard-Zoom-Modus ist „ FitInView “.
Siehe auch „ zoomMode()“, „ viewMode()“ und „ setViewMode()“.
[slot] void QPrintPreviewWidget::updatePreview()
Diese Funktion aktualisiert die Vorschau, wodurch das Signal „ paintRequested()“ ausgelöst wird.
QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const
Gibt den aktuellen Anzeigemodus zurück. Der Standardanzeigemodus ist „ SinglePageView “.
Siehe auch ` setViewMode()` .
qreal QPrintPreviewWidget::zoomFactor() const
Gibt den Zoomfaktor der Ansicht zurück.
Siehe auch ` setZoomFactor()`.
[slot] void QPrintPreviewWidget::zoomIn(qreal factor = 1.1)
Vergrößert die aktuelle Ansicht um den Wert „ factor “. Der Standardwert für „ factor “ ist 1,1, was bedeutet, dass die Ansicht um 10 % vergrößert wird.
QPrintPreviewWidget::ZoomMode QPrintPreviewWidget::zoomMode() const
Gibt den aktuellen Zoom-Modus zurück.
Siehe auch setZoomMode(), viewMode() und setViewMode().
[slot] void QPrintPreviewWidget::zoomOut(qreal factor = 1.1)
Vergrößert die aktuelle Ansicht um den Wert „ factor “. Der Standardwert für „ factor “ ist 1,1, was bedeutet, dass die Ansicht um 10 % verkleinert wird.
© 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.