Share via


Evento Player.MediaChange

[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 MediaChange ocorre quando um item de mídia é alterado.

Sintaxe

Player.MediaChange(
  Item
)

Parâmetros

Item

Objeto de mídia que representa o item que foi alterado.

Retornar valor

Esse evento não retorna um valor.

Comentários

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.

Reprodutor Multimídia do Windows 10 Mobile: não há suporte para esse evento.

Exemplos

O exemplo de JScript a seguir usa um elemento DIV HTML, chamado MediaName, para exibir o nome do item de mídia atual. O código atualiza o texto no DIV com cada ocorrência do evento mediaChange . O objeto Player foi criado com 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 Valor
Versão
Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL
Wmp.dll

Confira também

Objeto Player