PrintDlgEx

[Это предварительный документации и темы для изменения].

PrintDlgEx функция отображает лист свойств печати , который позволяет пользователю задать свойства конкретного задания печати. Лист свойств печати имеет Общие страницы, содержащей элементы управления, аналогичные Общие диалогового окна Печать . Окно свойств также может иметь дополнительные приложения и конкретного драйвера страницы свойств после Общие страницы.

() HRESULT PrintDlgEx LPPRINTDLGEX  lppd / / указатель на структуру с инициализации данных);
 

Параметры

lppd
Указатель на структуру PRINTDLGEX , содержащий информацию, используемую для инициализации свойств. Когда возвращается PrintDlgEx , эта структура содержит сведения о выбранных пользователем.

Возвращаемые значения

Если функция успешно, возвращаемое значение равно S_OK и dwResultAction член PRINTDLGEX структуры содержит одно из следующих значений.

Значение Значение
PD_RESULT_APPLY Пользователь нажал кнопку Применить и затем нажали кнопку Отмена . Это означает, что пользователь хочет, чтобы применить изменения, внесенные в окне свойств, но еще не печатать не нужно. PRINTDLGEX структура содержит сведения, указанные пользователем в то время, что была нажата кнопка Применить.
PD_RESULT_CANCEL Пользователь нажал кнопку Отмена . Информация, содержащаяся в PRINTDLGEX структуре не меняется.
PD_RESULT_PRINT Пользователь нажал кнопку Печать . PRINTDLGEX структура содержит сведения, указанные пользователем.

Если вызов функции был неуспешен, возвращаемое значение может быть одним из следующих кодов ошибок COM. Для получения дополнительной информации, смотрите Обработка ошибок.

Значение Значение
E_OUTOFMEMORY Недостаточно памяти.
E_INVALIDARG Один или несколько аргументов являются недопустимыми.
E_POINTER Неверный указатель.
E_HANDLE Недопустимый дескриптор.
E_FAIL Неизвестная ошибка.

Примечания

Для получения дополнительной информации см. Окно свойств печати.

QuickInfo

nbsp; Windows &NT: требует версии 5.0 или более поздней.
Windows:Не поддерживается.
Windows CE:Не поддерживается.
Заголовок:Объявленные в commdlg.h.
Импорта библиотеки:Используйте comdlg32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Общие диалогового окна Обзор библиотеки, Общие функции окна диалога, CreatePropertySheetPage, PrintDlg, PRINTDLGEX

Index