CPSUICBPARAM 구조체(compstui.h)

아티클
03/08/2023

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

CPSUICBPARAM 구조체의 CPSUI 제공 크기(바이트)입니다.

Reason

콜백 함수를 호출하는 이유를 나타내는 CPSUI 제공 값입니다. 다음 값 중 하나일 수 있습니다.

CPSUICB_REASON_ABOUT

사용자가 페이지의 정보 단추를 클릭했으며 애플리케이션은 이전에 COMPROPSHEETUI 구조에서 CPSUIF_ABOUT_CALLBACK 플래그를 설정했습니다. CPSUI 는 pCurItem 을 pOptItem에 포함된 값으로 설정하고 pOldSel 을 COMPROPSHEETUI 구조를 가리키도록 설정합니다.

CPSUICB_REASON_APPLYNOW

사용자가 페이지의 적용 또는 확인 단추를 클릭했으며 CPSUI에서 PSN_APPLY 알림 메시지를 받았습니다. CPSUI는 pOptItem 이 가리키는 옵션을 가리키도록 pCurItem 을 설정합니다. 또한 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

pCurItem으로 식별되는 옵션은 푸시 단추(TVOT_PUSHBUTTON 옵션 유형)이며 사용자가 단추를 클릭했습니다.

누름 단추 항목의 OPTPARAM스타일 필드가 PUSHBUTTON_TYPE_CALLBACK 설정됩니다.

CPSUICB_REASON_SEL_CHANGED

사용자가 pCurItem에서 가리키는 옵션에 대해 선택한 값을 변경했습니다.

CPSUICB_REASON_SETACTIVE

속성 시트 페이지가 활성화되고 CPSUI가 PSN_SETACTIVE 알림 메시지를 받았습니다. CPSUI 는 pCurItem 을 pOptItem에 포함된 값으로 설정하고 pOldSel 을 COMPROPSHEETUI 구조를 가리키도록 설정합니다.

hDlg

현재 활성 대화 상자에 대한 CPSUI 제공 핸들입니다.

pOptItem

OPTITEM 구조체 배열에 대한 CPSUI 제공 포인터입니다. 이는 애플리케이션이 이전에 COMPROPSHEETUI 구조에서 제공한 것과 동일한 포인터입니다.

cOptItem

CPSUI에서 제공하는 pOptItem이 가리키는 배열의 OPTITEM 구조체 수입니다. 이는 애플리케이션이 이전에 COMPROPSHEETUI 구조에서 제공한 것과 동일한 수입니다.

Flags

CPSUI 제공 플래그입니다. 이는 애플리케이션이 이전에 COMPROPSHEETUI 구조에서 제공한 것과 동일한 플래그 집합입니다.

pCurItem

pOptItem이 가리키는 OPTITEM 배열의 멤버에 대한 CPSUI 제공 포인터입니다. 이 배열 멤버는 콜백 함수가 호출된 "현재" 옵션을 나타냅니다.

DUMMYUNIONNAME

DUMMYUNIONNAME 공용 구조체를 정의합니다.

DUMMYUNIONNAME.OldSel

Reason 멤버에 CPSUICB_REASON_SEL_CHANGED 포함된 경우 CPSUI는 이 공용 구조체를 pCurItem이 가리키는 OPTITEM 구조체의 OldSel/pOldSel 멤버의 이전 콘텐츠로 설정합니다.

다른 모든 이유 값의 경우 이 공용 구조체의 내용을 무시해야 합니다.

DUMMYUNIONNAME.pOldSel

다른 모든 이유 값의 경우 이 공용 구조체의 내용을 무시해야 합니다.

UserData

CPSUI에서 제공하는 사용자 데이터입니다. 이는 애플리케이션이 이전에 COMPROPSHEETUI 구조에서 제공한 것과 동일한 값입니다.

Result

_CPSUICALLBACK 형식의 콜백 함수에서 제공하는 결과 값입니다. 기본적으로 CPSUI는 이 값을 CPSUI_OK 설정합니다. 콜백 함수가 반환되면 CPSUI는 CPSFUNC_SET_RESULT 함수 코드를 사용하여 ComPropSheet 함수를 호출하여 Reason 멤버 콘텐츠를 결과 값으로 제공합니다.

이 멤버는 Reason 멤버가 CPSUICB_REASON_APPLYNOW 콜백 함수가 CPSUI_ACTION_NO_APPLY_EXIT 반환하지 않는 경우에만 사용됩니다.

요구 사항

요구 사항	값
헤더	compstui.h(Compstui.h 포함)

Share via