SetPlayList

Kategorie: Musik
Ab Engineversion: 4.9.1.0 GWE

Beschreibung

Setzt die Liste der Musikstücke, die in zufälliger Reihenfolge abgespielt werden sollen (wenn die Musik aktiviert ist). Zurückgegeben wird die Anzahl der aktivierten Musikstücke (Im Netzwerk wird allerdings immer 0 zurückgegeben).

Syntax

int SetPlayList (string szPlayList);

Parameter

szPlayList:
[opt] Liste der abzuspielenden Musikstücke. Dabei werden die Einzeldateinamen jeweils mit einem Semikolon (";") getrennt. Wildcards dürfen benutzt werden. Wird der Parameter wegelassen, so wird die Standard-Musikliste gespielt.

Anmerkungen

Durch Aufruf von SetPlayList wird die Musik nicht aktiviert, wenn sie vorher deaktiviert war. Der Aufruf wirkt sich dann erst aus, wenn die Musik wieder aktiviert wird.
Der Aufruf 'SetPlayList("*.*")' ist nicht identisch mit 'SetPlayList()'. Wird 'SetPlayList("*.*")' aufgerufen, so werden wirklich alle Musikstücke aktiviert, auch diejenigen, die mittels eines "@" im Namen von der Standard-PlayList ausgenommen wurden. 'SetPlayList()' aktiviert diese Musikstücke dagegen nicht.
Siehe auch: Music
PeterW, Januar 2003