Класс 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(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()

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

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

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

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

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

Эта функция была введена в Qt 4.5.

QPrinter *QPrintDialog::printer()

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

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

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

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

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

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

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