Animate_Play macro (commctrl.h)

Plays an AVI clip in an animation control. The control plays the clip in the background while the thread continues executing. You can use this macro or send the ACM_PLAY message explicitly.

Syntax

BOOL Animate_Play(
   HWND hwnd,
   UINT from,
   UINT to,
   UINT rep
);

Parameters

hwnd

Type: HWND

A handle to the animation control in which to play the AVI clip.

from

Type: UINT

The zero-based index of the frame where playing begins. The value must be less than 65,536. A value of zero means begin with the first frame in the AVI clip.

to

Type: UINT

The zero-based index of the frame where playing ends. The value must be less than 65,536. A value of -1 means end with the last frame in the AVI clip.

rep

Type: UINT

The number of times to replay the AVI clip. A value of -1 means replay the clip indefinitely.

Return value

Type: BOOL

Returns nonzero if successful, or zero otherwise.

Remarks

You can use Animate_Seek to direct the animation control to display a particular frame of the AVI clip.

Requirements