Evento Player.CurrentPlaylistChange

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O evento CurrentPlaylistChange ocorre quando algo é alterado na playlist atual.

Sintaxe

Player.CurrentPlaylistChange(
  change
)

Parâmetros

change

Número (longo) que indica que tipo de alteração ocorreu na playlist. Consulte o Player. Evento PlaylistChange para uma tabela de valores possíveis.

Retornar valor

Esse evento não retorna um valor.

Comentários

Esse evento não ocorre quando uma playlist diferente se torna a playlist atual. Isso só ocorre quando ocorre uma alteração na playlist atual, como um item de mídia que está sendo acrescentado à playlist.

O valor dos parâmetros de evento é especificado por Reprodutor Multimídia do Windows e pode ser acessado ou passado para um método em um arquivo JScript importado usando o nome do parâmetro fornecido. Esse nome de parâmetro deve ser digitado exatamente como mostrado, incluindo maiúsculas.

Exemplos

O exemplo de JScript a seguir atualiza o texto em um elemento DIV HTML, chamado PlItems, para exibir os nomes dos itens de mídia na playlist atual. O objeto Player foi criado com 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	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Objeto Player

Player.currentPlaylist

Player.PlaylistChange