다음을 통해 공유

IProgressDialog::SetCancelMsg 메서드(shlobj_core.h)

  • 아티클

사용자가 작업을 취소하는 경우 표시할 메시지를 설정합니다.

구문

HRESULT SetCancelMsg(
  [in] PCWSTR  pwzCancelMsg,
       LPCVOID pvResevered
);

매개 변수

[in] pwzCancelMsg

형식: PCWSTR

표시할 메시지를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

pvResevered

형식: LPCVOID

예약되어 있습니다. NULL로 설정합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

사용자가 취소를 클릭하더라도 애플리케이션은 IProgressDialog::StopProgressDialog 를 즉시 호출하여 대화 상자를 닫을 수 없습니다. 애플리케이션은 다음에 IProgressDialog::HasUserCancelled 를 호출하여 사용자가 작업을 취소했음을 검색할 때까지 기다려야 합니다. 이 지연이 중요할 수 있으므로 진행률 대화 상자는 텍스트 줄 1과 2를 지우고 3줄에 취소 메시지를 표시하여 사용자에게 즉각적인 피드백을 제공합니다. 이 메시지는 지연이 정상이며 진행률 대화 상자가 곧 닫히게 될 것임을 사용자에게 알리기 위한 것입니다. 일반적으로 "잠시 기다려주세요..."와 같이 설정됩니다.

요구 사항

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

추가 정보

IProgressDialog