Metode PlaylistCollection.getByName

Artikel
06/21/2023

[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 getByName mengambil objek PlaylistArray yang berisi daftar putar dengan nama yang ditentukan, jika ada.

Sintaks

retVal = PlaylistCollection.getByName(
  name
)

Parameter

name [in]: String yang berisi nama daftar putar yang akan diambil.

Menampilkan nilai

Metode ini mengembalikan objek PlaylistArray .

Keterangan

Gunakan PlaylistArray. hitung untuk menentukan apakah daftar putar ada. Jika hitungan adalah nol, daftar putar tidak ada.

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

Contoh

Contoh JScript berikut menggunakan playlistCollection. getByName untuk memeriksa objek playlistCollection untuk daftar putar bernama "ThreeList". Jika daftar putar "Threelist" ada, getByName menetapkan "ThreeList" sebagai daftar putar saat ini. Objek Pemutar dibuat dengan ID = "Pemutar".

//Retrieve the count of the playlists named "ThreeList".
var Checkit = Player.playlistCollection.getByName("ThreeList").count;

//Since duplicate playlist names are allowed, the count returned
//will be either zero (no playlist) or greater than zero 
//(playlist exists).
if (Checkit > 0){ 
    
   //Retrieve a playlistArray object containing "ThreeList". Assume that
   //there is only one playlist with that name, and assign it to the 
   //current playlist.
   Player.currentPlaylist = Player.playlistCollection.getByName("ThreeList").item(0);
}

Persyaratan

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

Lihat juga

Objek PlaylistArray
PlaylistArray.count
Objek PlaylistCollection
Settings.mediaAccessRights
Settings.requestMediaAccessRights

Share via