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 示例更新名为 PlItems 的 HTML DIV 元素中的文本，以显示当前播放列表中的媒体项的名称。 创建 ID 为“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