IShellPropSheetExt::AddPages 메서드(shobjidl_core.h)

셸이 파일 개체에 대해 표시하는 속성 시트에 하나 이상의 페이지를 추가합니다. 셸은 파일 형식에 등록된 각 속성 시트 처리기에 대해 이 메서드를 호출합니다.

구문

HRESULT AddPages(
  [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
  [in] LPARAM                 lParam
);

매개 변수

[in] pfnAddPage

형식: LPFNADDPROPSHEETPAGE

속성 시트 처리기가 속성 시트에 페이지를 추가하기 위해 호출하는 함수에 대한 포인터입니다. 함수는 CreatePropertySheetPage 함수에서 반환된 속성 시트 핸들과 이 메서드에 전달된 lParam 매개 변수를 사용합니다.

[in] lParam

형식: LPARAM

pfnAddPage가 가리키는 함수에 전달할 처리기별 데이터입니다.

반환 값

형식: HRESULT

성공하면 은 1 기반 인덱스 를 반환하여 처음에 표시해야 하는 페이지를 지정합니다. 자세한 내용은 설명 부분을 참조하십시오.

설명

속성 시트 처리기가 속성 시트에 추가해야 하는 각 페이지에 대해 처리기는 PROPSHEETPAGE 구조를 채우고 CreatePropertySheetPage 함수를 호출한 다음 pfnAddPage가 가리키는 함수를 호출합니다.

LPFNADDPROPSHEETPAGE 함수 포인터 형식은 다음과 같이 Prsht.h에 정의되어 있습니다. lParam을 통해 PROPSHEETPAGE 구조 및 함수 정의 데이터에 대한 핸들을 허용합니다.

typedef BOOL (* LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);

구현을 통해 기본 페이지 대신 특정 속성 시트 페이지를 먼저 표시할 것을 요청할 수 있습니다. 이렇게 하려면 추가한 페이지를 기준으로 원하는 페이지의 단일 기반 인덱스 를 반환합니다. 예를 들어 A, B 및 C라는 세 개의 속성 시트 페이지를 추가하고 B를 선택한 페이지로 지정하려는 경우 반환 값은 2여야 합니다. 이 반환 값은 요청일 뿐입니다. 속성 시트는 여전히 기본 페이지를 표시할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 4.0 이상)