External.OnViewChange 事件

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意

本主题介绍专为在线商店使用而设计的功能。 不支持在在线商店的上下文之外使用此功能。

当视图在Windows 媒体播放器中更改时，将发生 OnViewChange 事件。

window.external.OnViewChange = FunctionName

可能的值

这是一个只写属性，用于指定脚本中Windows 媒体播放器事件发生时调用的函数的名称。

parameters

处理此事件的函数不采用任何参数。

备注

Windows 媒体播放器中的视图可能会因以下任一原因而更改：

• 用户与Windows 媒体播放器用户界面交互。
• 用户与发现页面交互，发现页上的脚本调用 External.changeView。
• 用户与发现页面交互，发现页上的脚本调用 External.changeViewOnlineList。

当视图在 Windows 媒体播放器 中更改时，播放器调用 IWMPContentPartner：：GetTemplate 来获取要显示的下一个发现页面的 URL。 但是，在 Player 显示新的发现页面之前，它会引发 OnViewChange 事件。 如果 OnViewChange 事件处理程序调用 External.cancelNavigate，Windows 媒体播放器不显示新的发现页。 而是继续显示当前发现页面。

要求

要求	值
版本	Windows Media Player 11
DLL	Wmp.dll

另请参阅

类型 1 在线商店的外部对象

External.changeView

External.changeViewOnlineList