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 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPrintPreviewWidget ist Teil von Printer und Printing 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 |
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:
- 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.
- 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.
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 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.
Konstante | Wert | Beschreibung |
---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | Der Zoom wird auf einen benutzerdefinierten Zoomwert gesetzt. |
QPrintPreviewWidget::FitToWidth | 1 | Dieser Modus passt die aktuelle Seite an die Breite der Ansicht an. |
QPrintPreviewWidget::FitInView | 2 | In 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.