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

void Animate_Play(
   hwnd,
   from,
   to,
   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

None

Remarks

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

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	commctrl.h