Metodo PlaylistCollection.newPlaylist

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo newPlaylist crea una nuova playlist nella libreria.

Sintassi

retVal = PlaylistCollection.newPlaylist(
  name
)

Parametri

name [in]

Stringa contenente il nome della playlist da creare.

Valore restituito

Questo metodo restituisce un oggetto Playlist .

Commenti

Questo metodo crea una playlist vuota nella libreria. Per riempire la playlist con elementi multimediali, usa Playlist. appendItem o Playlist. insertItem.

Nella libreria sono consentite più playlist con lo stesso nome. Per evitare di creare un nome di playlist duplicato con questo metodo, usare getByName e PlaylistArray. conteggio per determinare se esiste già una playlist con un nome specifico.

Gli spazi iniziali e finali non sono consentiti nei nomi delle playlist e vengono rimossi automaticamente dal valore specificato per il parametro name .

Per usare questo metodo, è necessario l'accesso completo alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esempio

L'esempio JScript seguente crea una nuova playlist vuota denominata "ThreeList". L'oggetto Player è stato creato con ID="Player".

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

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

MediaCollection.add

Playlist.appendItem

Playlist.insertItem

PlaylistArray.count

Oggetto PlaylistCollection

PlaylistCollection.getByName

PlaylistCollection.importPlaylist

PlaylistCollection.remove

Settings.mediaAccessRights

Settings.requestMediaAccessRights