Player.MediaChange 事件

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

MediaChange 事件在媒体项更改时发生。

语法

Player.MediaChange(
  Item
)

参数

项目

表示已更改的项的媒体对象。

返回值

此事件不返回值。

备注

事件参数的值由Windows 媒体播放器指定，可以使用给定的参数名称访问或传递到导入的 JScript 文件中的方法。 此参数名称必须完全如所示键入，包括大写。

Windows 媒体播放器 10 移动版：不支持此事件。

示例

下面的 JScript 示例使用名为 MediaName 的 HTML DIV 元素来显示当前媒体项的名称。 代码使用 每次出现 mediaChange 事件更新 DIV 中的文本。 创建的 Player 对象 ID 为“Player”。

<!-- Create an event handler for media change. -->
<SCRIPT FOR = "Player" EVENT = "mediaChange(Item)">
   // Test whether a valid currentMedia object exists.
   if (Player.currentMedia){
      // Display the name of the current media item.
      MediaName.innerHTML = Player.currentMedia.name;
   }
</SCRIPT>

要求

要求 值
版本
 Windows 媒体播放器版本 7.0 或更高版本。
DLL
Wmp.dll

另请参阅

Player 对象