INSERTPSUIPAGE_INFO 구조체(compstui.h)

  • 아티클

INSERTPSUIPAGE_INFO 구조체는 함수 코드가 CPSFUNC_INSERT_PSUIPAGE 경우 CPSUI의 ComPropSheet 함수에 대한 입력 매개 변수로 사용됩니다. 모든 멤버 값은 ComPropSheet 호출자가 제공해야 합니다.

구문

typedef struct _INSERTPSUIPAGE_INFO {
  WORD      cbSize;
  BYTE      Type;
  BYTE      Mode;
  ULONG_PTR dwData1;
  ULONG_PTR dwData2;
  ULONG_PTR dwData3;
} INSERTPSUIPAGE_INFO, *PINSERTPSUIPAGE_INFO;

멤버

cbSize

호출자가 제공한 INSERTPSUIPAGE_INFO 구조체의 크기(바이트)입니다.

Type

요청되는 삽입 유형을 나타내는 호출자 제공 정수 값입니다. 멤버는 다음 상수 중 하나를 포함할 수 있습니다.

PSUIPAGEINSERT_DLL

CPSUI는 이유 값이 PROPSHEETUI_REASON_INIT 지정된 PFNPROPSHEETUI 형식 함수를 호출합니다. 함수는 별도의 DLL에 포함되어 있습니다.

PSUIPAGEINSERT_GROUP_PARENT

CPSUI는 새 그룹 부모를 만듭니다.

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI는 CreatePropertySheetPage를 호출하여 만든 페이지를 삽입합니다.

함수 코드가 CPSFUNC_ADD_HPROPSHEETPAGEComPropSheet를 호출하는 것과 같습니다.

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI는 COMPROPSHEETUI 구조에서 설명하는 페이지를 삽입합니다.

함수 코드가 CPSFUNC_ADD_PCOMPROPSHEETUIComPropSheet를 호출하는 것과 같습니다.

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI는 이유 값이 PROPSHEETUI_REASON_INIT 지정된 PFNPROPSHEETUI 형식 함수를 호출합니다.

함수 코드가 CPSFUNC_ADD_PFNPROPSHEETUIComPropSheet를 호출하는 것과 같습니다.

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI는 지정된 PROPSHEETPAGE 구조에 설명된 페이지를 삽입합니다.

함수 코드가 CPSFUNC_ADD_PROPSHEETPAGEComPropSheet를 호출하는 것과 같습니다.

Mode

CPSUI가 새 페이지를 삽입해야 하는 위치를 나타내는 호출자 제공 값입니다. 다음 값 중 하나여야 합니다.

INSPSUIPAGE_MODE_AFTER

CPSUI는 lParam1 매개 변수로 지정된 CPSUI 페이지 핸들로 식별된 페이지 뒤에 페이지를 ComPropSheet에 삽입합니다.

INSPSUIPAGE_MODE_BEFORE

CPSUI는 lParam1 매개 변수로 지정된 CPSUI 페이지 핸들로 식별된 페이지 앞에 페이지를 ComPropSheet에 삽입합니다.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI는 hComPropSheet 매개 변수로 식별된 부모 그룹의 첫 번째 자식으로 페이지를 ComPropSheet에 삽입합니다.

ComPropSheet에 대한 lParam1 매개 변수는 무시됩니다.

INSPUIPAGE_MODE_INDEX

CPSUI는 hComPropSheet 매개 변수로 식별된 부모 그룹의 자식으로 페이지를 ComPropSheet에 삽입합니다.

ComPropSheet에 대한 lParam1 매개 변수는 자식 집합 내에서 지정된 페이지를 삽입해야 하는 위치를 식별하는 0부터 시작하는 인덱스를 지정합니다. lParam1이 0이면 페이지가 1페이지부터 삽입됩니다. lParam1이 1이면 페이지가 2페이지부터 삽입됩니다. 등등. 인덱스가 기존 자식 수보다 크면 새 페이지가 마지막 자식으로 추가됩니다. lParam1 값은 HINSPSUIPAGE_INDEX(index)로 지정해야 합니다.

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI는 hComPropSheet 매개 변수로 식별된 부모 그룹의 마지막 자식으로 페이지를 ComPropSheet에 삽입합니다.

ComPropSheet에 대한 lParam1 매개 변수는 무시됩니다.

dwData1

아래의 설명 섹션을 참조하세요.

dwData2

아래의 설명 섹션을 참조하세요.

dwData3

아래의 설명 섹션을 참조하세요.

설명

dwData1, dwData2 및 dwData3 멤버에는 다음과 같이 Type 멤버의 내용에 따라 달라지는 호출자 제공 값이 포함됩니다.

형식 멤버에 PSUIPAGEINSERT_DLL 포함

dwData1 - DLL 경로 이름을 나타내는 NULL로 끝나는 문자열에 대한 호출자 제공 포인터입니다.

dwData2 - 지정된 DLL에 포함된 PFNPROPSHEETUI 형식 함수의 이름을 나타내는 NULL로 끝나는 문자열에 대한 호출자 제공 포인터입니다.

dwData3 - lParam 매개 변수에 대한 PFNPROPSHEETUI 형식 함수에 전달된 호출자가 제공한 32비트 값입니다.

형식 멤버에 PSUIPAGEINSERT_GROUP_PARENT 포함

dwData1 - 사용되지 않으며 0이어야 합니다.

dwData2 - 사용되지 않으며 0이어야 합니다.

dwData3 - 사용되지 않으며 0이어야 합니다.

형식 멤버에 PSUIPAGEINSERT_HPROPSHEETPAGE 포함

dwData1 - CreatePropertySheetPage에서 반환된 속성 시트에 대한 호출자 제공 핸들입니다.

dwData2 - 사용되지 않으며 0이어야 합니다.

dwData3 - 사용되지 않으며 0이어야 합니다.

형식 멤버에 PSUIPAGEINSERT_PCOMPROPSHEETUI 포함

dwData1 - COMPROPSHEETUI 구조체에 대한 호출자 제공 포인터입니다.

dwData2 - 성공하면 삽입된 페이지 수를 받습니다. 오류가 발생하면 ERR_CPSUI 접두사 오류 코드가 수신됩니다.

dwData3 - 사용되지 않으며 0이어야 합니다.

형식 멤버에 PSUIPAGEINSERT_PFNPROPSHEETUI 포함

dwData1 - PFNPROPSHEETUI 형식 함수에 대한 호출자 제공 포인터입니다.

dwData2 - lParam 매개 변수에 대한 PFNPROPSHEETUI 형식 함수에 전달된 호출자가 제공한 32비트 값입니다.

dwData3 - 사용되지 않으며 0이어야 합니다.

형식 멤버에 PSUIPAGEINSERT_PROPSHEETPAGE 포함

dwData1 - PROPSHEETPAGE 구조체에 대한 호출자 제공 포인터입니다.

dwData2 - 사용되지 않으며 0이어야 합니다.

dwData3 - 사용되지 않으며 0이어야 합니다.

요구 사항

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