Evento External.OnViewChange

[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.]

Observação

Este tópico descreve a funcionalidade projetada para uso por lojas online. Não há suporte para o uso dessa funcionalidade fora do contexto de um repositório online.

O evento OnViewChange ocorre quando a exibição é alterada no Reprodutor Multimídia do Windows.

window.external.OnViewChange = FunctionName

Valores possíveis

Essa é uma propriedade somente gravação que especifica o nome da função no script que Reprodutor Multimídia do Windows chama quando o evento ocorre.

Parâmetros

A função que manipula esse evento não usa parâmetros.

Comentários

A exibição no Reprodutor Multimídia do Windows pode ser alterada por qualquer um dos seguintes motivos:

• O usuário interage com a interface do usuário Reprodutor Multimídia do Windows.
• O usuário interage com uma página de descoberta e o script na página de descoberta chama External.changeView.
• O usuário interage com uma página de descoberta e o script na página de descoberta chama External.changeViewOnlineList.

Quando a exibição é alterada no Reprodutor Multimídia do Windows, o Player chama IWMPContentPartner::GetTemplate para obter a URL da próxima página de descoberta a ser exibida. No entanto, antes que o Player exiba a nova página de descoberta, ele aciona o evento OnViewChange . Se o manipulador de eventos OnViewChange chamar External.cancelNavigate, Reprodutor Multimídia do Windows não exibirá a nova página de descoberta. Em vez disso, ele continua a exibir a página de descoberta atual.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows 11
DLL	Wmp.dll

Confira também

Objeto externo para repositórios online tipo 1

External.changeView

External.changeViewOnlineList