Player.MediaChange event

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The MediaChange event occurs when a media item changes.

Syntax

Player.MediaChange(
  Item
)

Parameters

Item

Media object representing the item that changed.

Return value

This event does not return a value.

Remarks

The value of event parameters is specified by Windows Media Player, and can be accessed or passed to a method in an imported JScript file using the parameter name given. This parameter name must be typed exactly as shown, including capitalization.

Windows Media Player 10 Mobile: This event is not supported.

Examples

The following JScript example uses an HTML DIV element, named MediaName, to display the name of the current media item. The code updates the text in the DIV with each occurrence of the mediaChange event. The Player object was created with 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>

Requirements

See also

Player Object