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

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

Страница 10 из 59

Функция 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_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 
Замечания по платформе		Не имеется

 

c++ форум