IActionProgress 接口 (shobjidl_core.h)

  • 项目

表示可以继承进度驱动操作的抽象基类。

继承

IActionProgress 接口继承自 IUnknown 接口。 IActionProgress 还具有以下类型的成员：

方法

IActionProgress 接口具有这些方法。

 
IActionProgress：：Begin

在需要向用户显示进度的操作开始时调用。
IActionProgress：：End

指示与此进度实现关联的操作已结束。
IActionProgress：：QueryCancel

提供有关操作是否正在取消的信息。
IActionProgress：：ResetCancel

取消完成后重置进度对话框。
IActionProgress：：UpdateProgress

汇报操作的进度到 UI。
IActionProgress：：UpdateText

如果与操作关联的描述性文本将发生更改，则调用 。

注解

此类是不能实例化的抽象类。 它提供派生类可用于实现进度回调的框架。 应用程序可以使用此回调向 UI 报告操作进度。 此处，“操作”是指可能需要很长时间的操作，例如下载或复制文件，在此期间，应使用可见的进度指示。

应用程序通常不实现此接口。 用户在操作期间与之交互的大部分功能都由 CProgressDialog 类 (CLSID_ProgressDialog) 提供，该类实现 IActionProgress 并在对话框中显示进度。 如果需要需要对话框以外的机制的解决方案，则可以使用 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