Animate_OpenEx 宏 (commctrl.h)

从指定模块中的资源打开 AVI 剪辑,并在动画控件中显示其第一帧。 可以使用此宏或显式发送 ACM_OPEN 消息。

语法

BOOL Animate_OpenEx(
   HWND      hwnd,
   HINSTANCE hInst,
   LPTSTR    szName
);

参数

hwnd

类型:HWND

动画控件的句柄。

hInst

类型:HINSTANCE

要从中加载资源的模块的实例句柄。 如果此值 NULL,则会从创建动画控件的模块加载资源。

szName

类型:LPTSTR

指向包含 AVI 文件路径或 AVI 资源名称的缓冲区的指针。 或者,此参数可以包含 LOWORD 中的 AVI 资源标识符,HIWORD中为零。 若要创建此值,请使用 MAKEINTRESOURCE 宏。 该控件从 hInst指定的模块加载 AVI 资源。 szName 指定的 AVI 文件或资源不得包含音频。

如果此参数 NULL,系统将关闭以前为指定动画控件打开的 AVI 文件(如果有)。

返回值

类型:BOOL

如果成功,则返回非零;否则返回零。

言论

只能打开无提示 AVI 剪辑。 如果 szName 指定包含声音的 AVI 剪辑,ACM_OPENAnimate_Open 将失败。

可以使用 Animate_Close 关闭以前为指定动画控件打开的 AVI 文件或 AVI 资源。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h