Поделиться через


Методы указания страниц

Внимание

Современная платформа печати — это предпочтительный способ взаимодействия с принтерами Windows. Рекомендуется использовать драйвер класса "Входящие" Microsoft IPP вместе с приложениями поддержки печати (PSA), чтобы настроить возможности печати в Windows 10 и 11 для разработки устройств принтера.

Дополнительные сведения см. в статье "Современная платформа печати" и руководство по проектированию приложений поддержки печати.

Приложение может использовать любой из трех методов, чтобы указать страницы листов свойств в CPSUI. Каждый из следующих методов включает вызов функции ComPropSheet CPSUI, указав один из кодов функций ComPropSheet.

  • Предоставление структуры COMPROPSHEETUI

    Если приложение описывает страницу листа свойств, передав структуру COMPROPSHEETUI в ComPropSheet, это может:

    • Используйте одну из указанных страниц и шаблонов CPSUI, чтобы указать предопределенный стандартный тип страницы, который библиотеки DLL интерфейса принтера могут использовать для листов свойств принтера.

    • Укажите набор параметров листа свойств, изменяемых пользователем, которые будут отображаться на странице.

    • Укажите функцию обратного вызова события страницы, которую CPSUI будет вызывать, когда пользователь просматривает или изменяет параметры страницы.

  • Предоставление структуры PROPSHEETPAGE

    Структура PROPSHEETPAGE может использоваться для описания страницы листа свойств, если страница не может быть создана с помощью общих (стандартных) диалогов, доступных при использовании структуры COMPROPSHEETUI. Библиотеки DLL интерфейса принтера обычно не должны использовать этот метод.

  • Предоставление функции обратного вызова

    Приложение может передать comPropSheet адрес функции обратного вызова, типизированной PFNPROPSHEETUI, которая CPSUI немедленно вызывает. Функция обратного вызова отвечает за вызов comPropSheet для создания страниц листов свойств.

    Средство spooler печати использует этот метод для информирования CPSUI о существовании функций DrvDocumentPropertySheets в интерфейсе принтера и DrvDevicePropertySheets. Аналогичным образом драйверы Unidrv и Pscript используют метод для информирования CPSUI о существовании IPrintOemUI::D ocumentPropertySheets и IPrintOemUI::D evicePropertySheets COM в подключаемых модулях пользовательского интерфейса.

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