Функция PrintDlgEx показывает на экране набор страниц свойств Печать (Print), который дает возможность пользователю задавать свойства конкретного задания печати. Набор страниц свойств Печать (Print) имеет Общую (General) страницу, содержащую такие же органы управления, что и диалоговое окно Печать (Print). Набор страниц свойств может также иметь и дополнительные специальные для приложения и конкретные для драйвера вкладки свойств, сопровождающие страницу Общие (General).
Синтаксис
HRESULT PrintDlgEx( LPPRINTDLGEX lppd ); |
Параметры
lppd
[in, out] Указатель на структуру PRINTDLGEX, которая содержит информацию, используемую для инициализации набора страниц свойств. Когда PrintDlgEx возвращает значение, эта структура содержит информацию о выборе пользователя.
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение равно S_OK, а член dwResultAction структуры PRINTDLGEX содержит одно из ниже перечисленных значений.
Значение Предназначение PD_RESULT_APPLY Пользователь щелкнул по кнопке Применить (Apply), а позже щелкнул по кнопке Отменить (Cancel). Это означает, что пользователь хочет применить изменения, сделанные в наборе страниц свойств, но еще не хочет печатать. Структура PRINTDLGEX содержит информацию, определенную пользователем, во время щелчка по кнопке Применить (Apply). PD_RESULT_CANCEL Пользователь щелкнул по кнопке Отменить (Cancel). Информация в структуре PRINTDLGEX не изменилась. PD_RESULT_PRINT Пользователь щелкнул по кнопке Печатать (Print). Структура PRINTDLGEX содержит информацию, определенную пользователем.
Если функция завершается ошибкой, возвращаемое значение может быть одним из ниже перечисленных кодов ошибки Объектной модели компонентов (COM). Для получения дополнительной информации, см. статью Обработка ошибок .
E_OUTOFMEMORY Недостаточная память. E_INVALIDARG Один или несколько параметров недействительны. E_POINTER Недопустимый указатель. E_HANDLE Недопустимый дескриптор. E_FAIL Неопределенная ошибка.
Замечания
|
Обратите внимание! на то, что значения членов hDevMode и hDevNames в структуре PRINTDLGEX могут измениться, когда они передаются в PrintDlgEx. Это происходит потому, что эти члены заполняются и при вводе данных и при их выводе. |
Для получения дополнительной информации, см. статью Набор страниц Свойства печати.
Пример
Пример смотри в статье Использование набора страниц Свойства печати.
Смотри также
Обзор Библиотека стандартных диалоговых окон, Функции, используемые библиотекой стандартных диалоговых окон, CreatePropertySheetPage, PrintDlg, PRINTDLGEX
|
Размещение и совместимость PrintDlgEx |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Нет |
|
Windows Me |
Нет |
|
Windows 98 |
Нет |
|
Windows 95 |
Нет |
|
Используемая библиотека |
Comdlg32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Commdlg.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |