QPrintPreviewWidget Class

Die Klasse QPrintPreviewWidget bietet ein Widget zur Vorschau von Seitenlayouts für die Druckausgabe. Mehr...

Kopfzeile: #include <QPrintPreviewWidget>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport
Vererbt: 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

Reimplementierte ö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()

Detaillierte Beschreibung

QPrintPreviewDialog verwendet intern ein QPrintPreviewWidget, und der Zweck von QPrintPreviewWidget ist es, die Vorschau in andere Widgets einzubetten. Es ermöglicht auch den Aufbau einer anderen Benutzeroberfläche als die standardmäßig mit QPrintPreviewDialog bereitgestellte.

Die Verwendung von QPrintPreviewWidget ist ganz einfach:

  1. Erstellen Sie das QPrintPreviewWidget

    Konstruieren Sie das QPrintPreviewWidget, indem Sie entweder ein bestehendes QPrinter Objekt übergeben, oder lassen Sie QPrintPreviewWidget ein standardmäßig konstruiertes QPrinter Objekt für Sie erstellen.

  2. Verbinden Sie das paintRequested() Signal mit einem Slot.

    Wenn das Widget einen Satz von Vorschauseiten erzeugen muss, wird ein paintRequested() Signal vom Widget ausgegeben. Verbinden Sie einen Slot mit diesem Signal und zeichnen Sie auf die als Signalparameter übergebene QPrinter. Rufen Sie QPrinter::newPage() auf, um eine neue Seite in der Vorschau zu beginnen.

Siehe auch QPrinter, QPrintDialog, QPageSetupDialog, und QPrintPreviewDialog.

Dokumentation der Mitgliedstypen

enum QPrintPreviewWidget::ViewMode

Diese Aufzählung wird verwendet, um den Ansichtsmodus des Vorschau-Widgets zu beschreiben.

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 Ansichtsmodus, in dem alle Seiten der Vorschau angezeigt werden.

enum QPrintPreviewWidget::ZoomMode

Diese Aufzählung wird verwendet, um den Zoom-Modus des Vorschau-Widgets zu beschreiben.

KonstanteWertBeschreibung
QPrintPreviewWidget::CustomZoom0Der Zoom wird auf einen benutzerdefinierten Zoomwert gesetzt.
QPrintPreviewWidget::FitToWidth1Dieser Modus passt die aktuelle Seite an die Breite der Ansicht an.
QPrintPreviewWidget::FitInView2In diesem Modus wird die aktuelle Seite in die Ansicht eingepasst.

Dokumentation der Mitgliedsfunktionen

[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Konstruiert ein QPrintPreviewWidget basierend auf printer und mit parent als übergeordnetes Widget. Die Widget-Flags flags werden an den QWidget Konstruktor weitergegeben.

Siehe auch QWidget::setWindowFlags().

[explicit] QPrintPreviewWidget::QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Dies ist eine überladene Funktion.

Sie veranlasst QPrintPreviewWidget, ein internes, standardmäßig konstruiertes QPrinter Objekt zu erstellen, das zur Erzeugung der Vorschau verwendet wird.

[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 Komfortfunktion und entspricht dem Aufruf von setZoomMode(QPrintPreviewWidget::FitInView).

[slot] void QPrintPreviewWidget::fitToWidth()

Dies ist eine Komfortfunktion und entspricht dem Aufruf von setZoomMode(QPrintPreviewWidget::FitToWidth).

QPageLayout::Orientation QPrintPreviewWidget::orientation() const

Gibt die aktuelle Ausrichtung der Vorschau zurück. Dieser Wert wird von dem mit der Vorschau verknüpften Objekt QPrinter bezogen.

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 ausgegeben, wenn das Vorschau-Widget eine Reihe von Vorschauseiten erzeugen muss. printer ist der Drucker, der mit diesem Vorschau-Widget verbunden ist.

[signal] void QPrintPreviewWidget::previewChanged()

Dieses Signal wird immer dann ausgegeben, wenn das Vorschau-Widget einen internen Zustand, wie z. B. die Ausrichtung, geändert hat.

[slot] void QPrintPreviewWidget::print()

Druckt die Vorschau auf dem mit der Vorschau verbundenen Drucker.

[slot] void QPrintPreviewWidget::setAllPagesViewMode()

Dies ist eine Komfortfunktion und entspricht dem Aufruf von setViewMode(QPrintPreviewWidget::AllPagesView).

[slot] void QPrintPreviewWidget::setCurrentPage(int page)

Legt die aktuelle Seite in der Vorschau fest. Dies bewirkt, dass die Ansicht an den Anfang von page springt.

Siehe auch currentPage().

[slot] void QPrintPreviewWidget::setFacingPagesViewMode()

Dies ist eine Komfortfunktion und entspricht dem Aufruf von setViewMode(QPrintPreviewWidget::FacingPagesView).

[slot] void QPrintPreviewWidget::setLandscapeOrientation()

Dies ist eine Komfortfunktion und entspricht dem Aufruf von setOrientation(QPageLayout::Landscape).

[slot] void QPrintPreviewWidget::setOrientation(QPageLayout::Orientation orientation)

Setzt die aktuelle Ausrichtung auf orientation. Dieser Wert wird auf das QPrinter Objekt gesetzt, das mit der Vorschau verbunden ist.

Siehe auch orientation().

[slot] void QPrintPreviewWidget::setPortraitOrientation()

Dies ist eine Komfortfunktion und entspricht dem Aufruf von setOrientation(QPageLayout::Portrait).

[slot] void QPrintPreviewWidget::setSinglePageViewMode()

Dies ist eine Komfortfunktion und entspricht dem Aufruf von setViewMode(QPrintPreviewWidget::SinglePageView).

[slot] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)

Setzt den Ansichtsmodus auf mode. Der Standard-Ansichtsmodus 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 bedeutet beispielsweise eine nicht skalierte Ansicht, was ungefähr der Größe entspricht, die die Ansicht auf dem Papier hat. 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)

Setzt den Zoom-Modus auf zoomMode. Der Standard-Zoom-Modus ist FitInView.

Siehe auch zoomMode(), viewMode(), und setViewMode().

[slot] void QPrintPreviewWidget::updatePreview()

Diese Funktion aktualisiert die Vorschau, woraufhin das Signal paintRequested() ausgegeben wird.

QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const

Gibt den aktuellen Ansichtsmodus zurück. Der Standard-Ansichtsmodus 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)

Zoomt die aktuelle Ansicht um factor heran. 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)

Verkleinert die aktuelle Ansicht um factor. Der Standardwert für factor ist 1,1, was bedeutet, dass die Ansicht um 10 % verkleinert wird.

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