Metode PlaylistCollection.newPlaylist

[Fitur yang terkait dengan halaman ini, Pemutar Media Windows SDK, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih Pemutar Media Windows SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode newPlaylist membuat daftar putar baru di pustaka.

Sintaks

retVal = PlaylistCollection.newPlaylist(
  name
)

Parameter

name [in]

String yang berisi nama daftar putar yang akan dibuat.

Menampilkan nilai

Metode ini mengembalikan objek Playlist .

Keterangan

Metode ini membuat daftar putar kosong di pustaka. Untuk mengisi daftar-putar dengan item media, gunakan Daftar-putar. appendItem atau Playlist. sisipkanItem.

Beberapa daftar putar yang memiliki nama yang sama diizinkan di pustaka. Untuk menghindari pembuatan nama daftar putar duplikat dengan metode ini, gunakan getByName dan PlaylistArray. hitung untuk menentukan apakah daftar putar dengan nama tertentu sudah ada.

Spasi di awal dan akhir tidak diizinkan dalam nama daftar putar, dan secara otomatis dihapus dari nilai yang ditentukan untuk parameter nama .

Untuk menggunakan metode ini, diperlukan akses penuh ke pustaka. Untuk informasi selengkapnya, lihat Akses Pustaka.

Contoh

Contoh JScript berikut membuat daftar putar kosong baru yang disebut "ThreeList". Objek Pemutar dibuat dengan ID="Pemutar".

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

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows versi 7.0 atau yang lebih baru.
DLL	Wmp.dll

Lihat juga

MediaCollection.add

Playlist.appendItem

Playlist.insertItem

PlaylistArray.count

Objek PlaylistCollection

PlaylistCollection.getByName

PlaylistCollection.importPlaylist

PlaylistCollection.remove

Settings.mediaAccessRights

Settings.requestMediaAccessRights