Peristiwa Player.CurrentPlaylistChange

[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.]

Peristiwa CurrentPlaylistChange terjadi ketika sesuatu berubah dalam daftar putar saat ini.

Sintaks

Player.CurrentPlaylistChange(
  change
)

Parameter

Perubahan

Angka (panjang) menunjukkan jenis perubahan apa yang terjadi pada daftar putar. Lihat Pemutar. Peristiwa PlaylistChange untuk tabel nilai yang mungkin.

Mengembalikan nilai

Kejadian ini tidak mengembalikan nilai.

Keterangan

Kejadian ini tidak terjadi ketika daftar putar yang berbeda menjadi daftar-putar saat ini. Ini hanya terjadi ketika perubahan terjadi dalam daftar putar saat ini, seperti item media yang ditambahkan ke daftar putar.

Nilai parameter peristiwa ditentukan oleh Pemutar Media Windows, dan dapat diakses atau diteruskan ke metode dalam file JScript yang diimpor menggunakan nama parameter yang diberikan. Nama parameter ini harus diketik persis seperti yang ditunjukkan, termasuk kapitalisasi.

Contoh

Contoh JScript berikut memperbarui teks dalam elemen HTML DIV, bernama PlItems, untuk menampilkan nama item media dalam daftar putar saat ini. Objek Pemutar dibuat dengan ID = "Pemutar".

<!-- Create an event handler for current playlist change. -->
<SCRIPT FOR = "Player" EVENT = "currentPlaylistChange(change)">
   switch (change){
      // Only update for move, delete, insert, and append events.
      case 3, 4, 5, 6:

         // Clear the contents of the DIV.
         PlItems.innerHTML = "";

         // Loop through the playlist and display each item name.
         for (var i = 0; i < Player.currentPlaylist.count; i++){
            PlItems.innerHTML += Player.currentPlaylist.item(i).name;
            PlItems.innerHTML += "<br>";
         }
         break;
      
      default:
   } 
</SCRIPT>

Persyaratan

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

Lihat juga

Objek Pemutar

Player.currentPlaylist

Player.PlaylistChange