| Prev Next
The Animate_Open macro opens an AVI clip and displays its first frame
in an animation control. You can use this macro or explicitly send the ACM_OPEN
message.
BOOL Animate_Open(
Parameters
-
hwnd
-
Handle to the animation control.
-
lpszName
-
Pointer to 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 an 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.
The AVI file or resource specified by lpszName must not contain audio.
It must be silent.
If this parameter is NULL, the system closes the .AVI file that was previously
opened for the specified animation control, if any.
Return Values
If the operation succeeds, the return value is a nonzero value.
If the operation fails, the return value is zero.
Remarks
You can only open silent AVI clips. AVI files or resources containing audio
will not load. ACM_OPEN and Animate_Open fail
if lpszSource specifies a non-silent AVI clip.
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 macro is defined in COMMCTRL.H.
See Also
ACM_OPEN, Animate_Close,
MAKEINTRESOURCE
|