IProgressDialog：：SetAnimation 方法 (shlobj_core.h)

  • 项目

[Windows Vista 或更高版本不支持此方法。]

指定在对话框中运行的 Audio-Video 交错 (AVI) 剪辑。

语法

HRESULT SetAnimation(
  [in, optional] HINSTANCE hInstAnimation,
                 UINT      idAnimation
);

参数

[in, optional] hInstAnimation

类型： HINSTANCE

应从中加载 AVI 资源的模块的实例句柄。

idAnimation

类型： UINT

AVI 资源标识符。 若要创建此值，请使用 MAKEINTRESOURCE 宏。 控件从 hInstAnimation 指定的模块加载 AVI 资源。

返回值

类型： HRESULT

如果成功，则返回 S_OK ，否则返回错误值。 在 Windows Vista 及更高版本中， 始终返回 S_OK。

注解

在进度对话框可见之前，无法调用 IProgressDialog：：SetAnimation。 在显示之前，进度对话框没有有效的 HWND。 HWND 的存在可用于确定是否可以调用 IProgressDialog：：SetAnimation 。

此方法采用 hInstAnimation 指定的实例句柄，并使用 动画控件 打开并运行无提示 AVI 剪辑。 对于可以使用哪些类型的 AVI 剪辑，有几个限制，包括：

  • 剪辑不能包含声音。
  • AVI 剪辑的大小不能超过 272 x 60 像素。 可以使用较小的矩形，但它们可能无法正确居中。
  • AVI 剪辑必须解压缩或使用运行长度 (BI_RLE8) 编码进行压缩。 如果尝试使用不受支持的压缩类型，则不会显示动画。

要求

   
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h
DLL Shell32.dll (5.0 或更高版本)

另请参阅

IProgressDialog