Функция PrintDlg показывает диалоговое окно Печать (Print). Диалоговое окно Печать (Print) дает возможность пользователю устанавливать свойства отдельного задания печати.
Windows 2000/XP: Функция PrintDlg была заменена функцией PrintDlgEx. PrintDlgEx показывает на экране набор страниц Свойства печати (Print Property Sheet), который имеет Общую (General) страницу, содержащую органы управления подобные диалоговому окну Печать (Print).
Синтаксис
BOOL PrintDlg( LPPRINTDLG lppd ); |
Параметры
lppd
[in, out] Указатель на структуру PRINTDLG, которая содержит информацию, используемую, чтобы инициализировать диалоговое окно. Когда PrintDlg возвращает значение, эта структура содержит информацию о выборе пользователя.Возвращаемые значения
Если пользователь щелкает мышью по кнопке OK, возвращаемое значение не нуль. Члены структуры PRINTDLG, указанные параметром lppd обозначают выбор пользователя.
Если пользователь прерывает работу или закрывает диалоговое окно Печать (Print), или Парметры принтера (Printer Setup), или происходит ошибка, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите функцию CommDlgExtendedError. Если пользователь отменил или закрыл диалоговое окно, CommDlgExtendedError возвращает нуль; в противном случае, она возвращает одно из ниже перечисленных значений.
CDERR_FINDRESFAILURE CDERR_INITIALIZATION CDERR_LOADRESFAILURE CDERR_LOADSTRFAILURE CDERR_LOCKRESFAILURE CDERR_MEMALLOCFAILURE CDERR_MEMLOCKFAILURE CDERR_NOHINSTANCE CDERR_NOHOOK CDERR_NOTEMPLATE CDERR_STRUCTSIZE PDERR_CREATEICFAILURE PDERR_DEFAULTDIFFERENT PDERR_DNDMMISMATCH PDERR_GETDEVMODEFAIL PDERR_INITFAILURE PDERR_LOADDRVFAILURE PDERR_NODEFAULTPRN PDERR_NODEVICES PDERR_PARSEFAILURE PDERR_PRINTERNOTFOUND PDERR_RETDEFFAILURE
Замечания
Если фильтр - процедура (указанная членом lpfnPrintHook или lpfnSetupHook структуры PRINTDLG) обрабатывает сообщение WM_CTLCOLORDLG, она должна возвратить дескриптор кисти, которая должна использоваться, чтобы окрасить фон органа управления.
Функция PrintDlg может также показать на экране и диалоговое окно Параметры печати (Print Setup). Однако, новые прикладные программы не должны использовать PrintDlg для этой цели. Диалоговое окно Параметры печати (Print Setup) было заменено диалоговым окном Параметры страницы (Page Setup), создаваемое функцией PageSetupDlg.
| Обратите внимание! на то, что значения hDevMode и hDevNames в структуре PRINTDLG могут измениться, когда они передаются в PrintDlg. Это происходит потому, что эти члены заполняются и при вводе данных, и при их выводе. |
Windows 95/98/Me: PrintDlgW поддерживается программой Microsoft Layer for Unicode (MSLU). Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.
Пример
Пример смотри в статье Показ на экране диалогового окна Печать (Print).
Смотри также
Обзор Библиотека стандартных диалоговых окон, Функции, используемые библиотекой стандартных диалоговых окон, CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG
|
Размещение и совместимость PrintDlg |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Comdlg32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Commdlg.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |