Método PlaylistCollection.newPlaylist

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método newPlaylist crea una nueva lista de reproducción en la biblioteca.

Sintaxis

retVal = PlaylistCollection.newPlaylist(
  name
)

Parámetros

name [in]

Cadena que contiene el nombre de la lista de reproducción que se va a crear.

Valor devuelto

Este método devuelve un objeto Playlist .

Observaciones

Este método crea una lista de reproducción vacía en la biblioteca. Para rellenar la lista de reproducción con elementos multimedia, use Lista de reproducción. appendItem o Playlist. insertItem.

Se permiten varias listas de reproducción con el mismo nombre en la biblioteca. Para evitar crear un nombre de lista de reproducción duplicado con este método, use getByName y PlaylistArray. recuento para determinar si ya existe una lista de reproducción con un nombre determinado.

Los espacios iniciales y finales no se permiten en los nombres de lista de reproducción y se quitan automáticamente del valor especificado para el parámetro name .

Para usar este método, se requiere acceso completo a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.

Ejemplos

En el ejemplo siguiente de JScript se crea una nueva lista de reproducción vacía denominada "ThreeList". El objeto Player se creó con ID="Player".

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

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

MediaCollection.add

Playlist.appendItem

Playlist.insertItem

PlaylistArray.count

PlaylistCollection (objeto)

PlaylistCollection.getByName

PlaylistCollection.importPlaylist

PlaylistCollection.remove

Settings.mediaAccessRights

Settings.requestMediaAccessRights