Функция обратного вызова PFNPROPSHEETUI (compstui.h)

Тип функции PFNPROPSHEETUI используется приложениями CPSUI (включая библиотеки DLL интерфейса принтера) для определения обратных вызовов создания страниц, которые указывают страницы страниц свойств для создания.

Синтаксис

PFNPROPSHEETUI Pfnpropsheetui;

LONG Pfnpropsheetui(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM lParam
)
{...}

Параметры

pPSUIInfo

Предоставленный CPSUI указатель на структуру PROPSHEETUI_INFO .

lParam

Предоставленное CPSUI целочисленное значение, зависящее от содержимого элемента Reasonструктуры PROPSHEETUI_INFO . Допустимы следующие значения:

PROPSHEETUI_REASON_BEFORE_INIT

Это значение является новым для Windows 8 и предоставляется только для исходного параметра PFNPROPSHEETUI, переданного в CommonPropertySheetUI.

PROPSHEETUI_REASON_DESTROY

Значение lParam не равно нулю, если пользователь выбрал кнопку "ОК" или "Отмена " на странице свойств. В противном случае значение равно нулю.

PROPSHEETUI_REASON_GET_ICON

Значение lParam является указателем на структуру PROPSHEETUI_GETICON_INFO .

PROPSHEETUI_REASON_GET_INFO_HEADER

Значение lParam является указателем на структуру PROPSHEETUI_INFO_HEADER .

PROPSHEETUI_REASON_INIT

Если функция обратного вызова указана параметром pfnPropSheetUIдля CommonPropertySheetUI, lParam — это значение lParam , передаваемое в CommonPropertySheetUI.

Если функция обратного вызова указана с помощью кода функции CPSFUNC_ADD_PFNPROPSHEETUI с функцией ComPropSheet CPSUI, lParam — это значение lParam2 , передаваемое в ComPropSheet.

CPSUI копирует значение lParam в элемент lParamInitструктуры PROPSHEETUI_INFO функции.

Значение lParam не должно находиться в стеке приложения.

PROPSHEETUI_REASON_SET_RESULT

Значение lParam является указателем на структуру SETRESULT_INFO .

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

Если операция выполнена успешно, функция должна вернуть значение , равное одному (или большему). В противном случае он должен вернуть значение меньше единицы.

Код возврата Описание
Один или больше. Будет вызвана функция PFNPROPSHEETUI, связанная с родительским элементом текущей страницы.
Меньше 1. Функция PFNPROPSHEETUI, связанная с родительским элементом текущей страницы, вызываться не будет.

Комментарии

Функции обратного вызова, указанные с помощью типа функции PFNPROPSHEETUI, предоставляются приложениями, которые используют CPSUI для управления настраиваемыми страницами страниц свойств. При вызове приложением функции CommonPropertySheetUI необходимо указать одну из таких функций обратного вызова. Например, когда диспетчер очереди печати на основе NT вызывает функцию CommonPropertySheetUI CPSUI для поддержки функций DocumentProperties или PrinterProperties , диспетчер очереди очереди указывает внутреннюю функцию обратного вызова PFNPROPSHEETUI.

Приложения могут указывать дополнительные функции обратного вызова типа PFNPROPSHEETUI, вызывая функцию ComPropSheet CPSUI с кодом функции CPSFUNC_ADD_PFNPROPSHEETUI. Например, диспетчер очереди печати на основе NT делает это, чтобы уведомить CPSUI о существовании функций DrvDocumentPropertySheets и DrvDevicePropertySheets интерфейса принтера. Аналогичным образом драйверы Unidrv и Pscript корпорации Майкрософт используют этот метод для уведомления CPSUI о существовании методов IPrintOemUI::D ocumentPropertySheets и IPrintOemUI::D evicePropertySheets в подключаемых модулях пользовательского интерфейса.

Каждая функция обратного вызова типа PFNPROPSHEETUI вызывается CPSUI несколько раз. Элемент Reason структуры PROPSHEETUI_INFO определяет операцию, которую должна выполнять функция, следующим образом:

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть compstui.h (включая Compstui.h)