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

Функции, предоставляемые CPSUI

  • Статья

Внимание

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

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

CPSUI предоставляет следующие две важные функции для приложений:

  • CommonPropertySheetUI

    Функция CommonPropertySheetUI — это точка входа CPSUI. Функция приводит к созданию и отображению страниц листа свойств, а затем позволяет просматривать и изменять их пользователем.

    Когда приложение вызывает CommonPropertySheetUI, оно предоставляет адрес обратного вызова создания страницы, описывающего созданные страницы. CPSUI вызывает этот обратный вызов, чтобы получить описания страниц. Затем он отображает страницы, позволяет пользователю приложения изменять значения, содержащиеся на странице, и доставлять измененные значения приложению с помощью обратных вызовов событий страницы. Функция CommonPropertySheetUI не возвращается, пока пользователь не уволил лист свойств, нажав кнопку "ОК" или "Отмена".

    Обратите внимание, что библиотеки DLL интерфейса принтера не вызывают эту функцию; он называется печатной spooler.

  • ComPropSheet

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

Подробное описание вызова этих функций см. в разделе "Использование CPSUI с драйверами принтера".

Две дополнительные функции, предоставляемые cpSUI, SetCPSUIUserData и GetCPSUIUserData, могут использоваться процедурами диалогового окна, предоставленными приложением, для хранения и получения предоставленного приложением значения.