Player.CurrentPlaylistChange 事件

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

CurrentPlaylistChange事件發生于目前播放清單內的某個專案變更時。

語法

Player.CurrentPlaylistChange(
  change
)

參數

change

數位 (長) 指出播放清單發生何種變更類型。 請參閱 播放機。可能值的資料表的PlaylistChange 事件。

傳回值

這個事件不會傳回值。

備註

當不同的播放清單變成目前的播放清單時，不會發生此事件。 只有在目前播放清單內發生變更時才會發生，例如將媒體專案附加至播放清單。

事件參數的值是由Windows 媒體播放機所指定，而且可以使用指定的參數名稱，存取或傳遞至匯入 JScript 檔案中的方法。 此參數名稱必須完全符合所顯示的類型，包括大寫。

範例

下列 JScript 範例會更新 HTML DIV 元素中名為 PlItems 的文字，以顯示目前播放清單中的媒體專案名稱。 Player物件是以識別碼 = 「Player」 建立的。

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

規格需求

需求	值
版本	Windows 媒體播放機 7.0 版或更新版本。
DLL	Wmp.dll

另請參閱

Player 物件

Player.currentPlaylist

Player.PlaylistChange