Evento Player.MediaChange

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El evento MediaChange se produce cuando cambia un elemento multimedia.

Sintaxis

Player.MediaChange(
  Item
)

Parámetros

Elemento

Objeto multimedia que representa el elemento que cambió.

Valor devuelto

Este evento no devuelve un valor.

Observaciones

El valor de los parámetros de evento se especifica mediante Reproductor multimedia de Windows y se puede acceder a él o pasarse a un método en un archivo JScript importado con el nombre de parámetro especificado. Este nombre de parámetro debe escribirse exactamente como se muestra, incluida la mayúsculas.

Reproductor multimedia de Windows 10 Mobile: este evento no es compatible.

Ejemplos

En el siguiente ejemplo de JScript se usa un elemento DIV HTML, denominado MediaName, para mostrar el nombre del elemento multimedia actual. El código actualiza el texto del DIV con cada aparición del evento mediaChange . El objeto Player se creó con 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>

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Player (objeto)