ACM_OPEN 消息

打开 AVI 剪辑，并在动画控件中显示其第一帧。可以显式发送此消息或使用 Animate\_Open 或 Animate\_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)