TDM_UPDATE_ICON 메시지

작업 대화 상자의 아이콘을 새로 고칩니다.

매개 변수

wParam[in]

업데이트할 아이콘 요소를 나타냅니다. 이 매개 변수는 다음 값 중 하나여야 합니다.

값	의미
TDIE_ICON_MAIN	기본 아이콘입니다.
TDIE_ICON_FOOTER	바닥글 아이콘입니다.

lParam[in]

표시할 문자열(PCWSTR) 또는 아이콘에 대한 핸들(HICON)을 가리키는 포인터입니다. lParam이 NULL이면 wParam 값에 관계없이 아이콘이 표시되지 않습니다.

wParam 값이 TDIE_ICON_MAIN이고, 작업 대화 상자를 만드는 데 사용되는 TASKDIALOGCONFIG 구조체의 dwFlags 멤버에 TDF_USE_HICON_MAIN 플래그가 설정된 경우 lParam은 표시할 아이콘에 대한 핸들(HICON)을 포함해야 합니다.

wParam 값이 TDIE_ICON_FOOTER이고, 작업 대화 상자를 만드는 데 사용되는 TASKDIALOGCONFIG 구조체의 dwFlags 멤버에 TDF_USE_HICON_FOOTER 플래그가 설정된 경우 lParam은 표시할 아이콘에 대한 핸들(HICON)을 포함해야 합니다.

TDF_USE_HICON_MAIN 또는 TDF_USE_HICON_FOOTER 플래그가 dwFlags 멤버에 설정되어 있지 않은 경우, lParam은 MAKEINTRESOURCE 매크로를 통해 전달된 유효한 리소스 식별자를 포함하는 null로 끝나는 PCWSTR(유니코드 문자열)을 가리켜야 합니다. 아이콘은 wParam 값을 기준으로 표시됩니다. 값이 TDIE_ICON_MAIN이면 아이콘이 헤더에 표시되고, 값이 TDIE_ICON_FOOTER이면 아이콘이 바닥글에 표시됩니다. 리소스는 애플리케이션의 리소스 모듈(TASKDIALOGCONFIG 구조체의 hInstance 멤버에 지정됨)에서 가져오거나, hInstance가 NULL인 경우 시스템의 리소스 모듈(imageres.dll)에서 가져와야 합니다. 시스템 리소스를 식별하려면 MAKEINTRESOURCE 매크로를 통해 전달된 유효한 시스템 식별자를 사용하거나 commctrl.h에서 미리 정의된 다음 값 중 하나를 사용합니다.

값	의미
TD_ERROR_ICON	중지 기호 아이콘입니다.
TD_WARNING_ICON	느낌표 아이콘입니다.
TD_INFORMATION_ICON	원 아이콘의 소문자 ‘i’입니다.
TD_SHIELD_ICON	보안 방패 아이콘입니다.

반환 값

반환 값은 무시됩니다.

설명

아이콘이 있는 작업 대화 상자의 레이아웃은 실패할 수 있으며 반환 값에 반영되지 않을 수 있습니다. S_OK 반환 값은 작업 대화 상자가 메시지를 수신하고 처리하려고 했다는 것만 반영합니다. 작업 대화 상자의 레이아웃이 실패하면 대화 상자가 닫히고 등록된 호출 함수에서 HRESULT 코드가 반환됩니다. 호출 함수 구문에 대한 자세한 내용은 TaskDialogCallbackProc를 참조하세요.

작업 대화 상자가 바닥글 없이 만들어지고(즉, 작업 대화 상자를 만드는 데 사용된 TASKDIALOGCONFIG 구조체의 적절한 바닥글 멤버가 NULL임) 이 메시지가 전송되면 바닥글이 작업 대화 상자에 동적으로 추가되지 않습니다. 헤더 없이 작업 대화 상자를 만들 때 이 메시지를 보내 헤더 아이콘을 업데이트하는 경우에도 마찬가지입니다. 런타임에 헤더 또는 바닥글을 추가하려면 TDM_NAVIGATE_PAGE 기능을 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
헤더	Commctrl.h