Класс QPrintDialog

Класс QPrintDialog предоставляет диалог для задания конфигурации принтера. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• options : PrintDialogOptions

Открытые функции

Переопределённые открытые функции

Сигналы

Подробное описание

Диалог позволяет пользователям изменять параметры, связанные с документом, такие как размер и ориентация бумаги, тип печати (цветная или черно-белая), диапазон страниц и количество копий для печати.

Также предоставляются средства для выбора доступных принтеров, включая настроенные сетевые принтеры.

Обычно объекты QPrintDialog создаются с объектом QPrinter и выполняются с помощью функции exec().

QPrintDialog printDialog(printer, parent);
if (printDialog.exec() == QDialog::Accepted) {
    // print ...
}

Если пользователь подтвердит диалог, объект QPrinter будет правильно настроен для печати.

Диалог принтера (показанный выше в стиле Plastique) предоставляет доступ к общим свойствам печати. В системах X11, использующих систему печати CUPS, параметры каждого доступного принтера можно изменить через кнопку Свойства диалога.

В Windows и macOS используется родной диалог печати, что означает, что некоторые свойства QWidget и QDialog, установленные в диалоге, не будут учтены. Родной диалог печати в macOS не поддерживает установку параметров принтера, т.е. setOptions() и setOption() не имеют эффекта.

В Qt 4.4 было возможно использовать статические функции для отображения листа в macOS. Эта возможность больше не поддерживается в Qt 4.5. Если вам нужна эта функциональность, используйте QPrintDialog::open().

См. также QPageSetupDialog и QPrinter.

Документация по членам-функциям

QPrintDialog::QPrintDialog(QWidget *parent = nullptr)

Создаёт диалог печати с заданным parent.

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

Создаёт новый модальный диалог печати для заданного printer с заданным parent.

[signal] void QPrintDialog::accepted(QPrinter *printer)

Этот сигнал излучается, когда пользователь подтверждает значения, заданные в диалоге печати. Параметр printer содержит принтер, к которому были применены настройки.

[virtual] QPrintDialog::~QPrintDialog()

Удаляет диалог печати.

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

Переопределяет: QDialog::done(int r).

Закрывает диалог и устанавливает его код результата в result. Если этот диалог показан с помощью exec(), done() завершает локальный цикл событий и exec() возвращает result.

Примечание: Эта функция не применяется к родному диалогу печати на платформах Mac macOS и Windows, так как диалог должен быть модальным и только пользователь может его закрыть.

См. также QDialog::done().

[override virtual] int QPrintDialog::exec()

Переопределяет: QDialog::exec().

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

Это перегруженная функция.

Открывает диалог и подключает его сигнал accepted() к слоту, заданному receiver и member.

Сигнал будет отключён от слота при закрытии диалога.

QPrinter *QPrintDialog::printer()

Возвращает принтер, на котором работает этот диалог печати. Это может быть полезно при использовании метода QPrintDialog::open().

void QPrintDialog::setOption(QAbstractPrintDialog::PrintDialogOption option, bool on = true)

Устанавливает заданный option, чтобы он был включён, если on имеет значение true; в противном случае, сбрасывает заданный option.

См. также options и testOption().

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

Переопределяет: QDialog::setVisible(bool visible).

bool QPrintDialog::testOption(QAbstractPrintDialog::PrintDialogOption option) const

Возвращает true, если заданный option включён; в противном случае, возвращает false.

См. также options и setOption().