Methods > Playlists > PlayListSetShuffle method

Remarks

Sets the playlist execution in random order.

The execution order is changed each time this method is called with the bShuffle parameter set to "BOOL_TRUE".

If the playlist has the Loop mode set to "BOOL_TRUE" (through the PlayListSetLoop method), each time the playlist is completed the execution order is automatically changed.

For further details about playlists management see the How to create and manage a playlist tutorial.

Syntax

[Visual Basic]

control.PlayListSetShuffle (

nPlayer as Integer,

bShuffle as enumBoolean

) as enumErrorCodes

[C++]

short control.PlayListSetShuffle (

short nPlayer,

short bShuffle

);

Parameter

Description

nPlayer

Number representing the zero-based index of the player that owns the playlist

bShuffle

Boolean value that specifies to execute the playlist in shuffle mode

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	Playlist is executed in ordered mode
BOOL_TRUE	1	Playlist is executed in Shuffle mode

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The call was successful.