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