Evento External.OnViewChange

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

Nota:

En este tema se describe la funcionalidad diseñada para su uso por las tiendas en línea. No se admite el uso de esta funcionalidad fuera del contexto de una tienda en línea.

El evento OnViewChange se produce cuando cambia la vista en Reproductor multimedia de Windows.

window.external.OnViewChange = FunctionName

Valores posibles

Se trata de una propiedad de solo escritura que especifica el nombre de la función en el script que Reproductor multimedia de Windows llama cuando se produce el evento.

Parámetros

La función que controla este evento no toma ningún parámetro.

Observaciones

La vista de Reproductor multimedia de Windows puede cambiar por cualquiera de los siguientes motivos:

• El usuario interactúa con la interfaz de usuario Reproductor multimedia de Windows.
• El usuario interactúa con una página de detección y el script de la página de detección llama a External.changeView.
• El usuario interactúa con una página de detección y el script de la página de detección llama a External.changeViewOnlineList.

Cuando la vista cambia en Reproductor multimedia de Windows, el Reproductor llama a IWMPContentPartner::GetTemplate para obtener la dirección URL de la siguiente página de detección que se va a mostrar. Sin embargo, antes de que el Reproductor muestre la nueva página de detección, genera el evento OnViewChange . Si el controlador de eventos OnViewChange llama a External.cancelNavigate, Reproductor multimedia de Windows no muestra la nueva página de detección. En su lugar, continúa mostrando la página de detección actual.

Requisitos

Requisito	Value
Versión	Reproductor de Windows Media 11
Archivo DLL	Wmp.dll

Consulte también

Objeto externo para tiendas en línea de tipo 1

External.changeView

External.changeViewOnlineList