Plays an AVI clip in an animation control. The control plays the clip in the background while the thread continues executing. You can send this message explicitly or by using the Animate_Play macro.
To send this message, call the
SendMessage
function as follows.
Syntax
lResult = SendMessage( // returns LRESULT in lResult
(HWND) hWndControl, // handle to destination control
(UINT) ACM_PLAY, // message ID
(WPARAM) wParam, // = (WPARAM) (UINT) cRepeat
(LPARAM) lParam // = (LPARAM) MAKELONG(wFrom, wTo)
);
Parameters
- cRepeat
-
The number of times to replay the AVI clip. A value of -1 means replay the clip indefinitely.
- wFrom
-
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.
- wTo
-
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.
Return Value
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.
Message Information
| Header | commctrl.h |
|---|
| Minimum operating systems |
Windows NT 3.51, Windows 95 |
|---|