QPrintPreviewDialog Class
Die Klasse QPrintPreviewDialog bietet einen Dialog zur Vorschau und Konfiguration von Seitenlayouts für die Druckerausgabe. Mehr...
| Kopfzeile: | #include <QPrintPreviewDialog> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport)target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| Vererbt: | QDialog |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPrintPreviewDialog ist Teil der Standard Dialogs und Printer and Printing APIs.
Öffentliche Funktionen
| QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| virtual | ~QPrintPreviewDialog() |
| void | open(QObject *receiver, const char *member) |
| QPrinter * | printer() |
Reimplementierte öffentliche Funktionen
| virtual void | done(int result) override |
| virtual void | setVisible(bool visible) override |
Signale
| void | paintRequested(QPrinter *printer) |
Detaillierte Beschreibung
Die Verwendung von QPrintPreviewDialog in Ihrer bestehenden Anwendung ist sehr einfach:
- Erstellen Sie den QPrintPreviewDialog.
Sie können einen QPrintPreviewDialog mit einem bestehenden QPrinter Objekt erstellen, oder Sie können QPrintPreviewDialog einen für Sie erstellen lassen, der der Standarddrucker des Systems sein wird.
- Verbinden Sie das Signal paintRequested() mit einem Slot.
Wenn der Dialog eine Reihe von Vorschauseiten erzeugen muss, wird das Signal paintRequested() ausgegeben. Sie können für den eigentlichen Druck genau denselben Code verwenden wie für die Erzeugung der Vorschau, einschließlich des Aufrufs QPrinter::newPage(), um eine neue Seite in der Vorschau zu beginnen. Verbinden Sie einen Slot mit dem Signal paintRequested(), wo Sie auf das QPrinter Objekt zeichnen, das in den Slot übergeben wird.
- Rufen Sie exec() auf.
Rufen Sie QPrintPreviewDialog::exec() auf, um den Vorschaudialog anzuzeigen.
Siehe auch QPrinter, QPrintDialog, QPageSetupDialog, und QPrintPreviewWidget.
Dokumentation der Mitgliedsfunktionen
[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Konstruiert einen QPrintPreviewDialog basierend auf printer und mit parent als übergeordnetes Widget. Die Widget-Flags flags werden an den QWidget Konstruktor weitergegeben.
Siehe auch QWidget::setWindowFlags().
[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Dies ist eine überladene Funktion.
Es wird ein internes QPrinter Objekt erstellt, das den Standarddrucker des Systems verwendet.
[virtual noexcept] QPrintPreviewDialog::~QPrintPreviewDialog()
Zerstört die QPrintPreviewDialog.
[override virtual] void QPrintPreviewDialog::done(int result)
Reimplements: QDialog::done(int r).
void QPrintPreviewDialog::open(QObject *receiver, const char *member)
Dies ist eine überladene Funktion.
Öffnet den Dialog und verbindet sein finished(int)-Signal mit dem durch receiver und member angegebenen Slot.
Das Signal wird vom Slot getrennt, wenn der Dialog geschlossen wird.
[signal] void QPrintPreviewDialog::paintRequested(QPrinter *printer)
Dieses Signal wird ausgegeben, wenn QPrintPreviewDialog eine Reihe von Vorschauseiten erzeugen muss.
Die mitgelieferte Instanz printer ist das Malgerät, auf das Sie den Inhalt jeder Seite malen sollten, indem Sie die Instanz QPrinter auf dieselbe Weise verwenden, wie Sie es beim direkten Drucken tun würden.
QPrinter *QPrintPreviewDialog::printer()
Gibt einen Zeiger auf das QPrinter Objekt zurück, auf dem dieser Dialog gerade läuft.
[override virtual] void QPrintPreviewDialog::setVisible(bool visible)
Reimplements: QDialog::setVisible(bool visible).
© 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.
