ACM_OPEN


		Contents Index Topic Contents
	Previous Topic: Animation Control Messages Next Topic: ACM_PLAY

ACM_OPEN
ACM_OPEN 
#if (_WIN32_IE >= 0x0400)
    wParam = (WPARAM)(HINSTANCE)hinst;
#else
    wParam = 0; 
#endif
    lParam = (LPARAM) (LPSTR) lpszName; 
Opens an AVI clip and displays its first frame in an animation control. You can send this message explicitly or use the Animate_Open or Animate_OpenEx macro.
Returns nonzero if successful, or zero otherwise.

hinst
Version 4.71. Instance handle to the module that the resource should be loaded from. If this value is NULL, the resource is loaded from the module that created the animation control.
lpszName
Address of a buffer that contains the path of the AVI file or the name of an AVI resource. Alternatively, this parameter can consist of the AVI resource identifier in the low-order word and zero in the high-order word. To create this value, use the MAKEINTRESOURCE macro. The control loads the AVI resource from the module specified by the instance handle passed to the CreateWindow function, the Animate_Create macro, or the dialog box creation function that created the control. In Version 4.71 and later, the resource is loaded from the module specified by hinst.
The AVI file or resource specified by lpszName must not contain audio.
If this parameter is NULL, the system closes the AVI file that was previously opened for the specified animation control, if any.

You can only open silent AVI clips. ACM_OPEN and Animate_Open fail if lpszSource specifies an AVI clip that contains sound.
You can use Animate_Close to close an AVI file or AVI resource that was previously opened for the specified animation control.
The Animate_Open and Animate_Close macros are defined in Commctrl.h.

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.