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 포함) |