Класс QPrintDialog

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

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

Свойства

• options : PrintDialogOptions

• 2 свойства унаследованы от QDialog
• 58 свойств унаследованы от QWidget
• 1 свойство унаследовано от QObject

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

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

• 11 открытых функций унаследованы от QAbstractPrintDialog
• 8 открытых функций унаследованы от QDialog
• 211 открытых функций унаследованы от QWidget
• 31 открытых функций унаследованы от QObject
• 14 открытых функций унаследованы от QPaintDevice

Сигналы

• 3 сигнала унаследованы от QDialog
• 3 сигнала унаследованы от QWidget
• 2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

• 5 открытых слотов унаследованы от QDialog
• 19 открытых слотов унаследованы от QWidget
• 1 открытый слот унаследован от QObject
• 5 статических открытых членов унаследованы от QWidget
• 11 статических открытых членов унаследованы от QObject
• 7 защищённых функций унаследованы от QDialog
• 35 защищённых функций унаследованы от QWidget
• 9 защищённых функций унаследованы от QObject
• 1 защищённая функция унаследована от QPaintDevice
• 1 защищённый слот унаследован от QWidget

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

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

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

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

Обычно объекты 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 = Q_NULLPTR)

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

QPrintDialog::QPrintDialog(QWidget *parent = Q_NULLPTR)

Конструктор по умолчанию для объекта QPrintDialog.

QPrintDialog::~QPrintDialog()

Уничтожает диалоговое окно печати.

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

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

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

Переопределено из QDialog::done().

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

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

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

[virtual] int QPrintDialog::exec()

Переопределено из QDialog::exec().

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

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

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

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

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

QPrinter *QPrintDialog::printer()

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

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

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

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

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

Переопределяет метод QWidget::setVisible().

bool QPrintDialog::testOption(PrintDialogOption option) const

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

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