Método External.NavigateTaskPaneURL

[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 método NavigateTaskPaneURL abre una página web en el panel de tareas especificado y cambia el foco al panel especificado.

Sintaxis

External.NavigateTaskPaneURL(
  bstrKeyName,
  bstrTaskPane,
  bstrParams
)

Parámetros

bstrKeyName [in]

Cadena que contiene el nombre de clave de la tienda en línea. (necesario)

bstrTaskPane [in]

Cadena que contiene el nombre del panel de tareas en el que se abre la página web. (necesario)

bstrParams [in]

Cadena que contiene los parámetros de cadena de consulta que se van a anexar a la dirección URL especificada por el elemento Navigate del documento ServiceInfo. (opcional).

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

Navegar a un panel que la tienda en línea no admite puede hacer que la tienda en línea actual cambie.

El valor especificado para bstrParams solo es válido cuando se llama a NavigateTaskPaneURL desde páginas web proporcionadas por la tienda en línea.

En la tabla siguiente se enumeran los valores válidos para bstrTaskPane y el panel de tareas asociado para cada uno.

Value	Panel de tareas
ServiceTask1	Primer panel de tareas de la tienda en línea.
ServiceTask2	Segundo panel de tareas de la tienda en línea.
ServiceTask3	Tercer panel de tareas de la tienda en línea.

El código de la página web debe especificar un valor para External.SelectedTaskPane al cargar para asegurarse de que el botón de panel de tareas correcto está resaltado una vez completada la navegación.

Ejemplos

En el código de ejemplo siguiente se muestra cómo NavigateTaskPaneURL crea la dirección URL de la página web que se va a mostrar para ServiceTask1.

Ejemplo del elemento Navigate :

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

Llamada de ejemplo al método NavigateTaskPaneURL :

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

Ejemplo de dirección URL resultante usada para la página web que se muestra en ServiceTask1:

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

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows 10 o posterior
Archivo DLL	Wmp.dll

Consulte también

Objeto externo para tiendas en línea de tipo 2

External.SelectedTaskPane