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

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

Синтаксис

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Параметры

pCPSUICBParam

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

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

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

Код возврата Описание
CPSUICB_ACTION_ITEMS_APPLIED Для элемента reason структуры CPSUICBPARAM задано значение CPSUICB_REASON_APPLYNOW, а функция обратного вызова успешно обработала текущие значения параметров.
CPSUICB_ACTION_NO_APPLY_EXIT Для элемента reason структуры CPSUICBPARAM задано значение CPSUICB_REASON_APPLYNOW, но функция обратного вызова обнаружила недопустимые или несовместимые значения параметров. Функция обратного вызова должна отображать диалоговое окно с сообщением пользователю о проблеме.
CPSUICB_ACTION_NONE Никаких действий cpSUI не требуется.
CPSUICB_ACTION_OPTIF_CHANGED Функция обратного вызова установила флаг OPTIF_CHANGED в структуре OPTITEM , чтобы указать, что выбранный параметр изменился или что изменился другой флаг с префиксом OPTIF.
CPSUICB_ACTION_REINIT_ITEMS Функция обратного вызова установила флаг OPTIF_CHANGED в структуре OPTITEM , чтобы указать, что флаги или элементы pData связанной структуры OPTTYPE или OPTPARAM изменились.

Комментарии

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

Функция обратного вызова с типом _CPSUICALLBACK назначается странице страницы страницы свойств, включив его адрес в структуру COMPROPSHEETUI , которая передается функции ComPropSheet CPSUI при CPSFUNC_ADD_PCOMPROPSHEETUI кода функции.

Кроме того, функции обратного вызова можно назначать расширенным кнопкам push-уведомлений с помощью структур EXTPUSH .

При вызове одной из этих функций обратного вызова он получает указатель на структуру CPSUICBPARAM . Эта структура описывает текущие параметры параметра для страницы и указывает событие пользователя, вызвавшее вызываемую функцию. Функция обратного вызова отвечает за проверку и обработку параметров. Он должен отображать диалоговое окно, если параметр (или сочетание параметров) является недопустимым. Возвращаемое значение функции указывает CPSUI, нужно ли повторно воспроизвести или повторно инициализировать страницу.

Функции обратного вызова, указанные с этим типом функции, нельзя использовать, если член DlgProc структуры DLGPAGE задает процедуру диалогового окна, предоставляемую приложением. Это связано с тем, что _CPSUICALLBACK типизированные обратные вызовы вызываются из диалоговых процедур CPSUI, которые не используются, если приложение предоставляет собственные процедуры.

Требования

   
Целевая платформа Рабочий стол
Заголовок compstui.h (include Compstui.h)