функция обратного вызова _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 , чтобы указать, что элементы Flags или pData связанной структуры OPTTYPE или OPTPARAM изменились.

Комментарии

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

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

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

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

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

Требования

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