Remarks
Plays in loop mode a portion of sound that has been previously loaded through one of the many methods having the "Load" prefix like LoadSound or LoadSoundFromMemory,.
The loop can be disabled at any time in two ways:
| • | by calling the PlaySoundDisableLoop method: in this case the sound will continue playing without interruption until reaching the final position of the established range |
| • | by calling the PlaySound method: in this case the sound will continue playing without interruption until reaching the end of the sound file |
By default playback continues till the end of the defined range until the final position is not moved through the PlaySoundMoveFinalPos method.
A successful call to this method will fire the SoundPlaying event; each loop completion will cause the control to fire the RangeLoopDone event: the only exception is the completion of the latest loop that will cause the control to fire the SoundDone event.
Syntax
[Visual Basic]
control.PlaySoundRangeLoop (
nPlayer as Integer,
nFromPosition as Long,
nToPosition as Long,
nLoopCount as Long
) as enumErrorCodes
|
|
[C++]
short control.PlaySoundRangeLoop (
short nPlayer,
long nFromPosition,
long nToPosition,
long nLoopCount
);
|
|
Parameter
|
Description
|
|
|
nPlayer
|
Number representing the zero-based index of the player that will play the sound interval
|
nFromPosition
|
Range starting point in the unit specified by the ScaleUnits property. Set this value to 0 for playing from the sound beginning.
|
nToPosition
|
Range ending point in the unit specified by the ScaleUnits property. Set this value to -1 for playing till the song end
|
nLoopCount
|
Specifies the number of loops over the defined range. Set this value to -1 for setting an infinite loop
|
Return value
Value
|
Meaning
|
|
|
Negative value
|
An error occurred (see the LastError property for further error details)
|
enumErrorCodes.ERR_NOERROR (0)
|
The method call was successful
|
|
