QPageSetupDialog Class

The QPageSetupDialog class provides a configuration dialog for the page-related options on a printer. More...

Header: #include <QPageSetupDialog>
CMake: find_package(Qt6 COMPONENTS PrintSupport REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport
Inherits: QDialog

Public Functions

QPageSetupDialog(QWidget *parent = nullptr)
QPageSetupDialog(QPrinter *printer, QWidget *parent = nullptr)
virtual ~QPageSetupDialog()
void open(QObject *receiver, const char *member)
QPrinter *printer()

Reimplemented Public Functions

virtual void done(int result) override
virtual int exec() override
virtual void setVisible(bool visible) override

Detailed Description

On Windows and macOS the page setup dialog is implemented using the native page setup dialogs.

Note that on Windows and macOS custom paper sizes won't be reflected in the native page setup dialogs. Additionally, custom page margins set on a QPrinter won't show in the native macOS page setup dialog.

See also QPrinter and QPrintDialog.

Member Function Documentation

QPageSetupDialog::QPageSetupDialog(QWidget *parent = nullptr)

Constructs a page setup dialog that configures a default-constructed QPrinter with parent as the parent widget.

See also printer().

QPageSetupDialog::QPageSetupDialog(QPrinter *printer, QWidget *parent = nullptr)

Constructs a page setup dialog that configures printer with parent as the parent widget.

[virtual] QPageSetupDialog::~QPageSetupDialog()

Destroys the page setup dialog.

[override virtual] void QPageSetupDialog::done(int result)

Reimplements: QDialog::done(int r).

[override virtual] int QPageSetupDialog::exec()

Reimplements: QDialog::exec().

This virtual function is called to pop up the dialog. It must be reimplemented in subclasses.

void QPageSetupDialog::open(QObject *receiver, const char *member)

This is an overloaded function.

Opens the dialog and connects its accepted() signal to the slot specified by receiver and member.

The signal will be disconnected from the slot when the dialog is closed.

QPrinter *QPageSetupDialog::printer()

Returns the printer that was passed to the QPageSetupDialog constructor.

[override virtual] void QPageSetupDialog::setVisible(bool visible)

Reimplements: QDialog::setVisible(bool visible).

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