Animate_Open (Windows Embedded CE 6.0)

1/6/2010

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 CE. Use Animate_OpenEx instead.

Requirements

See Also

Reference

Animation Controls Macros