External.cancelNavigate 方法

注意

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

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

语法

External.cancelNavigate()

参数

此方法没有任何参数。

返回值

此方法不返回值。

注解

当视图在Windows 媒体播放器中更改时,玩家将调用在线商店的插件以确定下一个要显示的发现页面。 但是,在某些情况下,在线商店可能希望玩家继续显示现有发现页面。 以下过程确定玩家是否显示新的发现页面:

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

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

要求

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

另请参阅

类型 1 Online Store 的外部对象

External.changeViewOnlineList

External.OnViewChange