Share via


Animate_Open (Windows CE 5.0)

Send Feedback

This macro opens an AVI clip and displays its first frame in an animation control. You can use this macro or send the ACM_OPEN (Shell and User Interface) message explicitly.

BOOL Animate_Open(   HWND hwndAnim,   LPTSTR lpszName);

Parameters

  • hwndAnim
    Handle to the animation control.

  • lpszName
    Pointer to a buffer that contains the path of the AVI file. The AVI file 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.

Return Values

Returns nonzero if successful, or zero otherwise.

Remarks

You can only open silent AVI clips. ACM_OPEN and Animate_Open will fail if lpszName specifies an AVI clip that contains sound.

You can use Animate_Close to close an AVI file that was previously opened for the specified animation control.

Animate_Open will not work if the user passes a null handle as a parameter to the resources instance of the process that creates a given window control. This is because retrieving the handle to that instance is not supported on Windows CE. Use Animate_OpenEx instead.

Requirements

OS Versions: Windows CE 5.0
Header: Commctrl.h.

See Also

Animation Controls Macros

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.