IWMPPlaylistCollection :: newPlaylist, méthode

La méthode newPlaylist retourne une interface IWMPPlaylist pour une nouvelle playlist vide dans la bibliothèque.

Syntaxe

public IWMPPlaylist newPlaylist(
  System.String bstrName
);

Public Function newPlaylist( _
  ByVal bstrName As System.String _
) As IWMPPlaylist
Implements IWMPPlaylistCollection.newPlaylist

Paramètres

bstrName [ dans]

System. String qui est le nom de la nouvelle sélection.

Valeur de retour

Interface wmplib. IWMPPlaylist pour la nouvelle sélection.

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 IWMPPlaylist. appendItem ou IWMPPlaylist. 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 la méthode GetByName et IWMPPlaylistArray. 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 bstrName .

Avant d’appeler cette méthode, vous devez disposer d’un accès complet à la bibliothèque. Pour plus d’informations, consultez accès à la bibliothèque.

Exemples

L’exemple suivant crée une nouvelle sélection vide appelée « ThreeList », l’ajoute à la collection de sélections et lui retourne une interface. L’objet AxWMPLib. AxWindowsMediaPlayer est représenté par la variable Player.

// Add a new empty playlist, named ThreeList, to the playlist collection.
WMPLib.IWMPPlaylist newList = player.playlistCollection.newPlaylist("ThreeList");

'  Add a new empty playlist, named ThreeList, to the playlist collection.
Dim newList As WMPLib.IWMPPlaylist = player.playlistCollection.newPlaylist("ThreeList")

Spécifications

Condition requise Valeur
Version
Lecteur Windows Media série 9 ou version ultérieure.
Espace de noms
WMPLib
Assembly
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

Interface IWMPPlaylist (VB et C#)

IWMPPlaylist. appendItem (VB et C#)

IWMPPlaylist. insertItem (VB et C#)

IWMPPlaylistArray. count (VB et C#)

Interface IWMPPlaylistCollection (VB et C#)

IWMPPlaylistCollection. getByName (VB et C#)