Player.CurrentPlaylistChange-Ereignis

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Das CurrentPlaylistChange-Ereignis tritt auf, wenn sich etwas in der aktuellen Wiedergabeliste ändert.

Syntax

Player.CurrentPlaylistChange(
  change
)

Parameter

change

Zahl (lang) gibt an, welche Art der Änderung an der Wiedergabeliste aufgetreten ist. Sehen Sie sich den Player an. PlaylistChange-Ereignis für eine Tabelle mit möglichen Werten.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Bemerkungen

Dieses Ereignis tritt nicht auf, wenn eine andere Wiedergabeliste zur aktuellen Wiedergabeliste wird. Sie tritt nur auf, wenn eine Änderung innerhalb der aktuellen Wiedergabeliste erfolgt, z. B. wenn ein Medienelement an die Wiedergabeliste angefügt wird.

Der Wert von Ereignisparametern wird von Windows Medienwiedergabe angegeben und kann mithilfe des angegebenen Parameternamens auf eine Methode in einer importierten JScript-Datei zugegriffen oder an eine Methode übergeben werden. Dieser Parametername muss genau wie gezeigt eingegeben werden, einschließlich Großschreibung.

Beispiele

Im folgenden JScript-Beispiel wird der Text in einem HTML-DIV-Element namens PlItems aktualisiert, um die Namen der Medienelemente in der aktuellen Wiedergabeliste anzuzeigen. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<!-- 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>

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

Player-Objekt

Player.currentPlaylist

Player.PlaylistChange