Win32 API. Справочник по стандартному диалоговому окну
Страница 10. Функция PrintDlg


Функция PrintDlg

(ДиалоговоеОкноПечать)

Функция 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_FINDRESFAILUREPDERR_CREATEICFAILURE
CDERR_INITIALIZATIONPDERR_DEFAULTDIFFERENT
CDERR_LOADRESFAILUREPDERR_DNDMMISMATCH
CDERR_LOADSTRFAILUREPDERR_GETDEVMODEFAIL
CDERR_LOCKRESFAILUREPDERR_INITFAILURE
CDERR_MEMALLOCFAILUREPDERR_LOADDRVFAILURE
CDERR_MEMLOCKFAILUREPDERR_NODEFAULTPRN
CDERR_NOHINSTANCEPDERR_NODEVICES
CDERR_NOHOOKPDERR_PARSEFAILURE
CDERR_NOTEMPLATEPDERR_PRINTERNOTFOUND
CDERR_STRUCTSIZEPDERR_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
Замечания по платформеНе имеется

 

 
« Предыдущая статья   Следующая статья »