Структура CPSUICBPARAM (compstui.h)

Статья
07/16/2024

Структура CPSUICBPARAM используется в качестве входного параметра для _CPSUICALLBACK-типизированных функций обратного вызова.

Синтаксис

typedef struct _CPSUICBPARAM {
  WORD      cbSize;
  WORD      Reason;
  HWND      hDlg;
  POPTITEM  pOptItem;
  WORD      cOptItem;
  WORD      Flags;
  POPTITEM  pCurItem;
  union {
    LONG   OldSel;
    LPTSTR pOldSel;
  } DUMMYUNIONNAME;
  ULONG_PTR UserData;
  ULONG_PTR Result;
} CPSUICBPARAM, *PCPSUICBPARAM;

Члены

cbSize

Размер, предоставленный CPSUI в байтах структуры CPSUICBPARAM.

Reason

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

CPSUICB_REASON_ABOUT

Пользователь щелкнул кнопку страницы, а приложение ранее задало флаг CPSUIF_ABOUT_CALLBACK в структуре COMPROPSHEETUI. CPSUI задает pCurItem значением, содержащимся в pOptItem, и задает pOldSel, чтобы указать структуру COMPROPSHEETUI.

CPSUICB_REASON_APPLYNOW

Пользователь щелкнул кнопку Применить или ОК, а CPSUI получил сообщение PSN_APPLY уведомления. CPSUI задает pCurItem, чтобы указать на параметр, к которому точки pOptItem. Он также задает OldSel минус один, чтобы указать, что все допустимые значения измененных параметров должны применяться сейчас.

CPSUICB_REASON_DLGPROC

Параметр, определяемый pCurItem, является кнопкой нажатия (тип параметраTVOT_PUSHBUTTON), и пользователь щелкнул кнопку.

Для поля стиля для параметра кнопки OPTPARAM задано значение PUSHBUTTON_TYPE_DLGPROC.

CPSUICB_REASON_ECB_CHANGED

Параметр, определенный pCurItem, является расширенным флажоком, и пользователь изменил состояние поля.

CPSUICB_REASON_EXTPUSH

Параметр, определенный pCurItem является расширенной кнопкой нажатия, и пользователь щелкнул кнопку.

CPSUICB_REASON_ITEMS_REVERTED

Пользователь щелкнул кнопку отмены страницы, и CPSUI вернул все выбранные значения в исходные значения.

CPSUICB_REASON_KILLACTIVE

Страница листа свойств будет терять активацию, и CPSUI получил сообщение PSN_KILLACTIVE уведомления. CPSUI задает pCurItem значением, содержащимся в pOptItem, и задает pOldSel, чтобы указать структуру COMPROPSHEETUI.

CPSUICB_REASON_OPTITEM_SETFOCUS

Параметр, определенный pCurItem, получил фокус ввода.

CPSUICB_REASON_PUSHBUTTON

Для поля OPTPARAMstyle элемента кнопки задано значение PUSHBUTTON_TYPE_CALLBACK.

CPSUICB_REASON_SEL_CHANGED

Пользователь изменил выбранное значение для параметра, на который указывает pCurItem.

CPSUICB_REASON_SETACTIVE

Страница листа свойств будет активной, и CPSUI получил сообщение PSN_SETACTIVE уведомления. CPSUI задает pCurItem значением, содержащимся в pOptItem, и задает pOldSel, чтобы указать структуру COMPROPSHEETUI.

hDlg

Предоставленный обработчик CPSUI в активном диалоговом окне.

pOptItem

Предоставленный CPSUI указатель на массив структур OPTITE M. Это тот же указатель, что приложение, ранее предоставленное в структуре COMPROPSHEETUI.

cOptItem

Предоставленное cpSUI число структур OPTITEM в массиве, на которое указывает pOptItem. Это то же число, что приложение, ранее предоставленное в структуре COMPROPSHEETUI.

Flags

Флаги, предоставленные CPSUI. Это тот же набор флагов, что приложение, ранее предоставленное в структуре COMPROPSHEETUI.

pCurItem

Указатель, предоставленный CPSUI, на элемент массива OPTITEM, на который указывает pOptItem. Этот элемент массива представляет параметр current, который является тем, для которого была вызвана функция обратного вызова.

DUMMYUNIONNAME

Определяет объединение DUMMYUNIONNAME.

DUMMYUNIONNAME.OldSel

Если элемент причины содержит CPSUICB_REASON_SEL_CHANGED, CPSUI задает это объединение в предыдущее содержимое OldSelpOldSel член структуры OPTITEM, на которую указывает pCurItem.

Для всех остальных значений Причина содержимое этого объединения должно игнорироваться.

DUMMYUNIONNAME.pOldSel

Для всех остальных значений Причина содержимое этого объединения должно игнорироваться.

UserData

Предоставленные пользователем данные CPSUI. Это то же значение, что и приложение, ранее предоставленное в структуре COMPROPSHEETUI.

Result

Значение результата, предоставленное функцией обратного вызова _CPSUICALLBACKтипа. По умолчанию CPSUI задает для этого значения значение CPSUI_OK. После возврата функции обратного вызова CPSUI вызывает свою функцию ComPropSheet с кодом функции CPSFUNC_SET_RESULT, предоставляя содержимое элемента в качестве значения результата.

Этот элемент используется только в том случае, если элемент причина CPSUICB_REASON_APPLYNOW, а функция обратного вызова не возвращает CPSUI_ACTION_NO_APPLY_EXIT.

Требования

Требование	Ценность
заголовка	compstui.h (include Compstui.h)

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