Méthode PlaylistCollection. newPlaylist

La méthode newPlaylist crée une nouvelle sélection dans la bibliothèque.

Syntaxe

retVal = PlaylistCollection.newPlaylist(
  name
)

Paramètres

nom [ dans]

Chaîne contenant le nom de la sélection à créer.

Valeur de retour

Cette méthode retourne un objet playlist .

Notes

Cette méthode crée une sélection vide dans la bibliothèque. Pour remplir la sélection avec des éléments multimédias, utilisez la sélection. appendItem ou playlist. InsertItem.

Plusieurs playlists portant le même nom sont autorisées dans la bibliothèque. Pour éviter de créer un nom de playlist dupliqué avec cette méthode, utilisez GetByName et PlaylistArray. Count pour déterminer si une sélection portant un nom particulier existe déjà.

Les espaces de début et de fin ne sont pas autorisés dans les noms de playlist et sont automatiquement supprimés de la valeur spécifiée pour le paramètre Name .

Pour utiliser cette méthode, l’accès complet à la bibliothèque est requis. Pour plus d’informations, consultez accès à la bibliothèque.

Exemples

l’exemple de JScript suivant crée une nouvelle sélection vide appelée « ThreeList ». L’objet Player a été créé avec ID = "Player".

//Add a new empty playlist, named ThreeList, to the playlist collection.
var NewList = Player.playlistCollection.newPlaylist("ThreeList");

Spécifications

Condition requise Valeur
Version
Lecteur Windows Media version 7,0 ou ultérieure.
DLL
Wmp.dll

Voir aussi

MediaCollection. Add

Playlist. appendItem

Playlist. insertItem

PlaylistArray. Count

Objet PlaylistCollection

PlaylistCollection.getByName

PlaylistCollection.importPlaylist

PlaylistCollection. Remove

Paramètres. mediaAccessRights

Paramètres. requestMediaAccessRights