Remarks
Plays a portion of sound a given number of times.
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
|
|