다음을 통해 공유

PFNPROPSHEETCALLBACK 콜백 함수(prsht.h)

  • 아티클

속성 시트를 만들고 초기화할 때 시스템에서 호출하는 애플리케이션 정의 콜백 함수입니다.

구문

PFNPROPSHEETCALLBACK Pfnpropsheetcallback;

int Pfnpropsheetcallback(
  HWND unnamedParam1,
  UINT unnamedParam2,
  LPARAM unnamedParam3
)
{...}

매개 변수

unnamedParam1

형식: HWND

속성 시트에 대한 핸들입니다. 이 매개 변수를 일반적으로 hWnd라고 합니다.

unnamedParam2

형식: UINT

수신 중인 메시지입니다. 이 매개 변수를 일반적으로 uMsg라고 합니다.

이 매개 변수는 다음 값 중 하나입니다.

값 의미
PSCB_INITIALIZED (1)
 속성 시트가 초기화되고 있음을 나타냅니다. lParam(이름 없는Param3) 값은 이 메시지에 대해 0입니다.
PSCB_PRECREATE (2)
 속성 시트가 만들어질 예정임을 나타냅니다. hWnd(namedParam1) 매개 변수는 NULL이고 lParam(namedParam3) 매개 변수는 메모리에 있는 대화 상자 템플릿의 주소입니다. 이 템플릿은 DLGTEMPLATE 또는 DLGTEMPLATEEX 구조체와 하나 이상의 DLGITEMTEMPLATE 구조체 형식입니다. Aero 마법사 스타일(PSH_AEROWIZARD)을 사용하는 경우에는 이 메시지를 적용할 수 없습니다.
PSCB_BUTTONPRESSED (3)

버전 60 이상. 사용자가 속성 시트 대화 상자에서 단추를 누른 것을 나타냅니다. 이를 사용하도록 설정하려면 PROPSHEETHEADER.dwFlags 에서 PSH_USECALLBACK 지정하고 PROPSHEETHEADER.pfnCallback에서 이 콜백 함수의 이름을 지정합니다. lParam(Arg3) 값은 다음 중 하나입니다. Aero 마법사 스타일(PSH_AEROWIZARD)을 사용하는 경우에만 PSBTN_CANCEL 유효합니다.

단추 누름 lParam 값
정상 PSBTN_OK
취소 PSBTN_CANCEL
적용 PSBTN_APPLYNOW
닫기 PSBTN_FINISH

Comctl32.dll 버전 6 이상은 재배포할 수 없습니다. 이러한 버전의 Comctl32.dll 사용하려면 매니페스트에서 특정 버전을 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.

unnamedParam3

형식: LPARAM

메시지에 대한 추가 정보입니다. 이 매개 변수를 일반적으로 lParam이라고 합니다.

이 값의 의미는 uMsg (namedParam2) 매개 변수에 따라 달라집니다.

  • uMsg가 PSCB_INITIALIZED 또는 PSCB_BUTTONPRESSED 경우 이 매개 변수의 값은 0입니다.

  • uMsg가 PSCB_PRECREATE 경우 이 매개 변수는 속성 시트 대화 상자를 설명하는 DLGTEMPLATE 또는 DLGTEMPLATEEX 구조체에 대한 포인터가 됩니다. 구조체의 서명을 테스트하여 형식을 확인합니다. 서명이 0xFFFF 구조체가 확장된 대화 상자 템플릿이면 구조체가 표준 대화 상자 템플릿이 됩니다. 다음 예제에서는 이 작업을 수행하는 방법을 보여 줍니다.

    if (uMsg == PSCB_PRECREATE) 
{
     if (lParam)
     {
          DLGTEMPLATE *pDlgTemplate;
          DLGTEMPLATEEX *pDlgTemplateEx;

          pDlgTemplateEx = (DLGTEMPLATEEX *)lParam;  
          if (pDlgTemplateEx->signature == 0xFFFF)
          {
               // pDlgTemplateEx points to an extended  
               // dialog template structure.
          }
          else
          {
               // This is a standard dialog template
               //  structure.
               pDlgTemplate = (DLGTEMPLATE *)lParam;
          }
     }    
}

반환 값

형식: int

0을 반환합니다.

설명

PropSheetProc 콜백 함수를 사용하도록 설정하려면 PropertySheet 함수를 호출하여 속성 시트를 만들 때 PROPSHEETHEADER 구조를 사용합니다. pfnCallback 멤버를 사용하여 콜백 함수의 주소를 지정하고 dwFlags 멤버에서 PSP_USECALLBACK 플래그를 설정합니다.

PropSheetProc 은 애플리케이션 정의 함수 이름의 자리 표시자입니다. PFNPROPSHEETCALLBACK 형식은 PropSheetProc 콜백 함수의 주소입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 prsht.h