IActionProgress 인터페이스(shobjidl_core.h)

진행률 기반 작업이 상속할 수 있는 추상 기본 클래스를 나타냅니다.

상속

IActionProgress 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IActionProgress 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IActionProgress 인터페이스에는 이러한 메서드가 있습니다.

IActionProgress::Begin 진행률을 사용자에게 표시해야 하는 작업이 시작되면 호출됩니다.
IActionProgress::End 이 진행률 구현과 관련된 작업이 종료되었음을 나타냅니다.
IActionProgress::QueryCancel 작업이 취소되는지 여부에 대한 정보를 제공합니다.
IActionProgress::ResetCancel 취소가 완료된 후 진행률 대화 상자를 다시 설정합니다.
IActionProgress::UpdateProgress 작업의 진행률을 UI에 업데이트.
IActionProgress::UpdateText 작업과 연결된 설명 텍스트가 변경되면 호출됩니다.

설명

이 클래스는 인스턴스화되지 않을 수 있는 추상 클래스입니다. 파생 클래스가 진행률 콜백을 구현하는 데 사용할 수 있는 프레임워크를 제공합니다. 이 콜백은 애플리케이션에서 작업 진행률을 UI에 보고하는 데 사용할 수 있습니다. 여기서 "작업"은 파일 다운로드 또는 복사와 같이 상당한 시간이 걸릴 수 있고 표시되는 진행률 표시가 적절한 작업을 나타냅니다.

애플리케이션은 일반적으로 이 인터페이스를 구현하지 않습니다. 작업 중에 사용자가 상호 작용하는 대부분의 기능은 IActionProgress 를 구현하고 대화 상자에 진행률을 표시하는 CProgressDialog 클래스(CLSID_ProgressDialog)에서 제공됩니다. 대화 상자 이외의 메커니즘이 필요한 솔루션이 필요한 경우 IActionProgress 를 사용하여 기본 진행률 표시기 기능을 제공할 수 있습니다.

구현된 후에는 작업이 시작될 때 클래스에서 IActionProgress::Begin 을 호출해야 합니다. IActionProgress::UpdateProgress를 주기적으로 호출하여 진행률 정보로 UI를 업데이트해야 하며 IActionProgress::UpdateText를 호출하여 자세한 텍스트 정보를 UI에 전달해야 합니다. 취소 요청을 처리하려면 IActionProgress::QueryCancel 및 IActionProgress::ResetCancel을 호출해야 합니다. 작업이 끝나면 IActionProgress::End 를 호출해야 합니다.

요구 사항

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

추가 정보

IProgressDialog