Share via

Animate_OpenEx (Compact 2013)

  • Article

3/28/2014

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.

Syntax

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 Embedded Compact.

Requirements

Header

commctrl.h

See Also

Reference

Animation Controls Macros