(ДиалоговоеОкноПечать)
Функция PrintDlg показывает диалоговое окно Печать (Print) или диалоговое окно Установки для печати (Print Setup). Диалоговое окно Печать (Print) дает возможность пользователю установить свойства отдельного задания по выводу на печать.
Диалоговое окно Установки для печати (Print Setup) не должно использоваться в новых прикладных программах. Оно заменяется стандартным диалоговым окном Параметры Страницы (Page Setup), создаваемое функцией PageSetupDlg.
Синтаксис
BOOL PrintDlg ( LPPRINTDLG lppd // адрес структуры с данными инициализации );
Параметры
lppd
Указатель на структуру PRINTDLG, которая содержит информацию, используемую, чтобы инициализировать диалоговое окно. Когда PrintDlg возвращает значение, эта структура содержит информацию о выборе пользователя.
Возвращаемые значения
Если пользователь щелкает мышью по кнопке OK, возвращаемое значение не нуль. Элементы структуры PRINTDLG, указанные параметром lppd показывают выбор пользователя.
Если пользователь прерывает работу или закрывает диалоговое окно Печать (Print) или Установки для печати (Print Setup) или происходит ошибка, возвращаемое значение нулевое. Чтобы получать дополнительные данные об ошибках, используйте функцию CommDlgExtendedError, которая может возвратить одно из ниже перечисленных значений:
CDERR_FINDRESFAILURE PDERR_CREATEICFAILURE CDERR_INITIALIZATION PDERR_DEFAULTDIFFERENT CDERR_LOADRESFAILURE PDERR_DNDMMISMATCH CDERR_LOADSTRFAILURE PDERR_GETDEVMODEFAIL CDERR_LOCKRESFAILURE PDERR_INITFAILURE CDERR_MEMALLOCFAILURE PDERR_LOADDRVFAILURE CDERR_MEMLOCKFAILURE PDERR_NODEFAULTPRN CDERR_NOHINSTANCE PDERR_NODEVICES CDERR_NOHOOK PDERR_PARSEFAILURE CDERR_NOTEMPLATE PDERR_PRINTERNOTFOUND CDERR_STRUCTSIZE PDERR_RETDEFFAILURE
Замечания
Если фильтр - процедура (указанная элементом lpfnPrintHook или lpfnSetupHook структуры PRINTDLG) обрабатывает сообщение WM_CTLCOLORDLG, она должна возвратить дескриптор для кисти, которая должна использоваться, чтобы окрасить фон элемента управления.
Смотри также
CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG
Размещение и совместимость PrintDlg
Windows NT Да Win95 Да Win32s Да Импортируемая библиотека comdlg32.lib Заголовочный файл commdlg.h Уникод WinNT Замечания по платформе Не имеется