Auf dieser Seite

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

Ö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:

  1. 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.

  2. 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.

KonstanteWertBeschreibung
QPrintPreviewWidget::SinglePageView0Ein Modus, in dem einzelne Seiten in der Vorschau angezeigt werden.
QPrintPreviewWidget::FacingPagesView1Ein Modus, in dem die gegenüberliegenden Seiten in der Vorschau angezeigt werden.
QPrintPreviewWidget::AllPagesView2Ein Anzeigemodus, in dem alle Seiten der Vorschau angezeigt werden.

enum QPrintPreviewWidget::ZoomMode

Diese Enumeration dient zur Beschreibung des Zoom-Modus des Vorschau-Widgets.

KonstanteWertBeschreibung
QPrintPreviewWidget::CustomZoom0Der Zoom wird auf einen benutzerdefinierten Zoomwert eingestellt.
QPrintPreviewWidget::FitToWidth1In diesem Modus wird die aktuelle Seite an die Breite der Ansicht angepasst.
QPrintPreviewWidget::FitInView2In 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.