External.cancelNavigate 方法

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

注意

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

cancelNavigate 方法通知Windows 媒体播放器，即使播放器中的视图已更改，也不应显示新的发现页面。

语法

External.cancelNavigate()

参数

此方法没有任何参数。

返回值

此方法不返回值。

备注

当Windows 媒体播放器中的视图更改时，Player 会调用在线商店的插件，以确定接下来要显示的发现页面。 但在某些情况下，在线商店可能希望 Player 继续显示现有发现页面。 以下过程确定 Player 是否显示新的发现页面：

1. 用户在玩家的用户界面或发现页面上的操作请求玩家更改其视图。
2. Player 调用插件的 GetTemplate 方法来确定接下来要显示的发现页面。 Player 存储新发现页面的 URL，但此时不显示新的发现页面。
3. Player 引发 OnViewChange 事件。
4. 如果发现页面上的 OnViewChange 事件处理程序调用 cancelNavigate，则 Player 不会显示步骤 2) 中确定的新发现页 (。 而是继续显示现有发现页。 如果 OnViewChange 事件处理程序不调用 cancelNavigate，则 Player 会显示新的发现页面。

例如，假设 Player 当前正在显示选择了特定曲目的相册视图。 此外，假设当前发现页面是表示整个专辑的页面。 如果用户单击同一相册中的其他曲目，则玩家的视图会略有变化，以显示新曲目已选中。 但无需显示新的发现页。 表示整个相册的发现页面仍然是玩家要显示的相应页面。

要求

要求	值
版本	Windows 媒体播放器 11.
DLL	Wmp.dll

另请参阅

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

External.changeViewOnlineList

External.OnViewChange