PFTASKDIALOGCALLBACK 콜백 함수(commctrl.h)

TaskDialogCallbackProc 함수는 TaskDialogIndirect 함수와 함께 사용되는 애플리케이션 정의 함수입니다. 다양한 이벤트가 발생할 때 작업 대화 상자에서 메시지를 받습니다.

PFTASKDIALOGCALLBACK 형식은 이 호출 함수를 가리키는 포인터를 정의합니다. TaskDialogCallbackProc는 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

HRESULT Pftaskdialogcallback(
  [in] HWND hwnd,
  [in] UINT msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
       LONG_PTR lpRefData
)
{...}

매개 변수

[in] hwnd

형식: HWND

TaskDialog 창에 대한 핸들입니다. 콜백 프로시저가 TDN_DESTROYED 호출된 후 hwnd로 메시지를 계속 보내지 마세요.

[in] msg

형식: UINT

다음 알림 중 하나입니다.

알림	사용량
TDN_BUTTON_CLICKED	단추가 선택되었음을 나타냅니다. 단추의 명령 ID는 wParam으로 지정됩니다.
TDN_CREATED	작업 대화 상자가 만들어졌는지 나타냅니다.
TDN_DESTROYED	작업 대화 상자가 삭제되었음을 나타냅니다.
TDN_DIALOG_CONSTRUCTED	작업 대화 상자가 만들어졌지만 아직 표시되지 않음을 나타냅니다.
TDN_EXPANDO_BUTTON_CLICKED	expando 단추가 선택되었음을 나타냅니다.
TDN_HELP	작업 대화 상자에 포커스가 있는 동안 F1 키를 눌렀다는 것을 나타냅니다.
TDN_HYPERLINK_CLICKED	하이퍼링크가 선택되었음을 나타냅니다. 링크 텍스트에 대한 포인터는 lParam으로 지정됩니다.
TDN_NAVIGATED	탐색이 발생했음을 나타냅니다.
TDN_RADIO_BUTTON_CLICKED	라디오 단추가 선택되었음을 나타냅니다. 라디오 단추의 명령 ID는 wParam으로 지정됩니다.
TDN_TIMER	작업 대화 상자 타이머가 발생했음을 나타냅니다. 총 경과 시간은 wParam으로 지정됩니다. hwnd 매개 변수로 지정된 창에 TDM_SET_PROGRESS_BAR_POS 메시지를 보내 진행률 표시줄을 업데이트할 수 있습니다.
TDN_VERIFICATION_CLICKED	작업 대화 상자 확인 검사 상자가 선택되었음을 나타냅니다.

[in] wParam

형식: WPARAM

추가 알림 정보를 지정합니다. 이 매개 변수의 내용은 uNotification 매개 변수의 값에 따라 달라집니다.

[in] lParam

형식: LPARAM

추가 알림 정보를 지정합니다. 이 매개 변수의 내용은 uNotification 매개 변수의 값에 따라 달라집니다.

lpRefData

형식: LONG_PTR

애플리케이션별 데이터에 대한 포인터입니다. 작업 대화 상자를 만드는 데 사용되는 TASKDIALOGCONFIG 구조체의 lpCallbackData 멤버가 가리키는 데이터입니다.

반환 값

형식: HRESULT

반환 값은 처리 중인 알림과 관련이 있습니다. 단추 클릭에 응답할 때 작업 대화 상자를 닫지 않을 경우 구현에서 S_FALSE 반환해야 합니다. 그렇지 않으면 S_OK 반환합니다.

설명

애플리케이션은 TaskDialogIndirect를 통해 포인터를 통해 전달되는 TASKDIALOGCONFIG 구조체의 pfCallback 멤버에 주소를 전달하여 이 콜백 함수를 등록해야 합니다.

요구 사항

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