External.NavigateTaskPaneURL 方法

  • 项目

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

注意

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

NavigateTaskPaneURL 方法在指定任务窗格中打开网页，并将焦点更改为指定窗格。

语法

External.NavigateTaskPaneURL(
  bstrKeyName,
  bstrTaskPane,
  bstrParams
)

参数

bstrKeyName [in]

包含在线商店的密钥名称的字符串。 （必需）

bstrTaskPane [in]

包含 打开网页的任务窗格的名称的字符串。 （必需）

bstrParams [in]

包含 要追加到 ServiceInfo 文档的 Navigate 元素指定的 URL 的查询字符串参数的字符串。 （可选）

返回值

此方法不返回值。

备注

导航到在线商店不支持的窗格可能会导致当前在线商店发生更改。

仅当从在线商店提供的网页调用 NavigateTaskPaneURL 时，为 bstrParams 指定的值才有效。

下表列出了 bstrTaskPane 的有效值以及每个有效值的相关任务窗格。

值 任务窗格
ServiceTask1 第一个在线商店任务窗格。
ServiceTask2 第二个在线商店任务窗格。
ServiceTask3 第三个在线商店任务窗格。

网页代码应在加载时为 External.SelectedTaskPane 指定一个值，以确保导航完成后突出显示正确的任务窗格按钮。

示例

以下示例代码演示 NavigateTaskPaneURL 如何创建要为 ServiceTask1 显示的网页的 URL。

Navigate 元素的示例：

<Navigate
    BaseURL = "https://www.proseware.com/online store/html/navigate.asp">
</Navigate>

对 NavigateTaskPaneURL 方法的示例调用：

external.NavigateTaskPaneURL("Proseware", "ServiceTask1", "Pane=Store");

ServiceTask1 中显示的网页使用的结果 URL 示例：

https://www.proseware.com/online store/html/navigate.asp?Pane=Store

要求

要求 值
版本
 Windows 媒体播放器 10 或更高版本
DLL
Wmp.dll

另请参阅

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

External.SelectedTaskPane