Share via

Animate_Open (Compact 2013)

  • Article

3/28/2014

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.

Syntax

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 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_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 Embedded Compact. Use Animate_OpenEx instead.

Requirements

Header

commctrl.h

See Also

Reference

Animation Controls Macros