Animate_OpenEx (Windows CE 5.0)

Send Feedback

This macro opens an AVI clip from a resource in a specified module 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_OpenEx(   HWND hwndAnim,   HINSTANCE hinst,   LPTSTR lpszName);

Parameters

  • hwndAnim
    Handle to the animation control.

  • hinst
    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
    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 any AVI file that was previously opened for the specified animation control.

Return Value

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_OpenEx 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.

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.