Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Раздел "MSDN по-русски": http://www.bcbdev.ru/msdn/index.php
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции PrintDlgEx.
PrintDlgEx
Функция PrintDlgEx отображает страницу свойств "Печать" (Print), которая позволяет
пользователю указать свойства отдельного задания принтера. Страница свойств "Печать"
содержит вкладку "Общие" (General), на которой размещены элементы управления,
похожие на диалоговое окно "Печать" (Print). Страница свойств может также содержать
другие, специфичные для приложения и драйвера вкладки, следующие за вкладкой
"Общие".
HRESULT PrintDlgEx(
LPPRINTDLGEX lppd
);
Параметры
lppd – указатель на структуру типа PRINTDLGEX, которая содержит информацию, используемую
для инициализации страницы свойств. Когда PrintDlgEx завершает работу, эта структура
содержит информацию о выборе пользователя.
Возвращаемые значения
В случае успеха возвращается S_OK, а значение члена dwResultAction структуры
типа PRINTDLGEX содержит одно из следующих значений:
Значение Пояснение
PD_RESULT_APPLY Пользователь нажал кнопку "Применить" (Apply) и позднее нажал
кнопку "Отмена" (Cancel). Это показывает, что пользователь хочет применить изменения,
сделанные на странице свойств, но пока не хочет печатать. Структура типа PRINTDLGEX
содержит информацию, указанную пользователем, когда он нажал кнопку "Применить".
PD_RESULT_CANCEL Пользователь нажал кнопку "Отмена" (Cancel). Информация в структуре
типа PRINTDLGEX не изменилась.
PD_RESULT_PRINT Пользователь нажал кнопку "Печать" (Print). Структура типа PRINTDLGEX
содержит информацию, указанную пользователем.
В случае неудачи возвращается один из следующих кодов ошибок СОМ:
Значение Пояснение
E_OUTOFMEMORY Недостаточно памяти.
E_INVALIDARG Неверен один или более аргументов.
E_POINTER Неверный указатель.
E_HANDLE Неверный дескриптор.
E_FAIL Не установленная ошибка.
Комментарии
Обратите внимание, что значения hDevMode и hDevNames в PRINTDLGEX могут измениться,
когда они переданы в PrintDlgEx. Это происходит потому, что значения этих членов
структуры заполняются и при передаче структуры в функцию, и при возврате информации
в структуру по завершению работы функции.
Для дополнительной информации смотрите раздел "Страница свойств печати".
Требования
Заголовок: объявлена в Commdlg.h, подключать Windows.h.
Библиотека импорта: Comdlg32.lib.
Минимальные ОС: включена в Windows NT/2000.
См. также
CreatePropertySheetPage, PrintDlg, PRINTDLGEX.
Справочник по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
Дружественная рассылка "Программирование на WinAPI": http://subscribe.ru/catalog/comp.soft.prog.russianmsdn
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:stathome@rol.ru