Evento Player.CurrentPlaylistChange

[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 CurrentPlaylistChange se produce cuando cambia algo dentro de la lista de reproducción actual.

Sintaxis

Player.CurrentPlaylistChange(
  change
)

Parámetros

change

Número (largo) que indica qué tipo de cambio se produjo en la lista de reproducción. Consulta el Reproductor. Evento PlaylistChange para una tabla de valores posibles.

Valor devuelto

Este evento no devuelve un valor.

Observaciones

Este evento no se produce cuando una lista de reproducción diferente se convierte en la lista de reproducción actual. Solo se produce cuando se produce un cambio en la lista de reproducción actual, como un elemento multimedia que se anexa a la lista de reproducción.

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.

Ejemplos

En el siguiente ejemplo de JScript se actualiza el texto de un elemento DIV HTML, denominado PlItems, para mostrar los nombres de los elementos multimedia de la lista de reproducción actual. El objeto Player se creó con id. = "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>

Requisitos

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

Consulte también

Player (objeto)

Player.currentPlaylist

Player.PlaylistChange