使用英语阅读

通过


ACM_OPEN 消息

打开 AVI 剪辑,并在动画控件中显示其第一帧。 可以显式发送此消息或使用 Animate\_OpenAnimate\_OpenEx 宏。 建议使用此消息的 Unicode 版本 ACM_OPENW。

参数

wParam

版本 4.71 及更高版本。 要从中加载资源的模块的实例句柄。 将此值设置为 NULL,让控件使用用于创建窗口的 HINSTANCE 值。 请注意,如果窗口是由 DLL 创建的,则 wParam 的默认值为 DLL 的 HINSTANCE 值,而不是调用 DLL 的应用程序。

lParam

指向包含 AVI 文件路径或 AVI 资源名称的缓冲区的指针。 或者,此参数可以由 LOWORD 中的 AVI 资源标识符HIWORD 中的零组成。 若要创建此值,请使用 MAKEINTRESOURCE 宏。 该控件从传递给创建控件的 CreateWindow 函数、Animate_Create 宏或对话框创建函数的实例句柄指定的模块加载 AVI 资源。 在版本 4.71 及更高版本中,将从 wParam 指定的模块加载资源。 AVI 资源必须具有“AVI”类型。 如果此参数为 NULL,系统将关闭以前为指定动画控件打开的 AVI 文件(如果有)。

返回值

如果成功,返回不为零的值;否则返回零。

备注

lpszName 指定的 AVI 文件或资源不得包含音频。

建议使用此消息的 Unicode 版本 ACM_OPENW。

只能打开静音的 AVI 剪辑。 如果 lParam 指定了包含声音的 AVI 剪辑,则 ACM_OPEN 和 Animate_Open 会失败。

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

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
Header
Commctrl.h
Unicode 和 ANSI 名称
ACM_OPENW (Unicode) 和 ACM_OPENA (ANSI)