Функция PrintDlg

Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz