External.NavigateTaskPaneURL-Methode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Hinweis

In diesem Thema werden Funktionen beschrieben, die für die Verwendung durch Onlineshops entwickelt wurden. Die Verwendung dieser Funktionalität außerhalb des Kontexts eines Online-Shops wird nicht unterstützt.

Die NavigateTaskPaneURL-Methode öffnet eine Webseite im angegebenen Aufgabenbereich und ändert den Fokus auf den angegebenen Bereich.

Syntax

External.NavigateTaskPaneURL(
  bstrKeyName,
  bstrTaskPane,
  bstrParams
)

Parameter

bstrKeyName [in]

Zeichenfolge , die den Schlüsselnamen für den Online-Shop enthält. (erforderlich)

bstrTaskPane [in]

Zeichenfolge , die den Namen des Aufgabenbereichs enthält, in dem die Webseite geöffnet wird. (erforderlich)

bstrParams [in]

Zeichenfolge , die die Abfragezeichenfolgenparameter enthält, die an die URL angefügt werden sollen, die durch das Navigate-Element des ServiceInfo-Dokuments angegeben wird. (Optional)

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Das Navigieren zu einem Bereich, den Ihr Online-Shop nicht unterstützt, kann dazu führen, dass sich der aktuelle Online-Shop ändert.

Der für bstrParams angegebene Wert ist nur gültig, wenn NavigateTaskPaneURL von Webseiten aufgerufen wird, die vom Online-Shop bereitgestellt werden.

In der folgenden Tabelle sind die gültigen Werte für bstrTaskPane und der zugehörige Aufgabenbereich für jeden aufgeführt.

Wert	Aufgabenbereich
ServiceTask1	Erster Online-Store-Aufgabenbereich.
ServiceTask2	Zweiter Online-Store-Aufgabenbereich.
ServiceTask3	Dritter Online-Store-Aufgabenbereich.

Ihr Webseitencode sollte beim Laden einen Wert für External.SelectedTaskPane angeben, um sicherzustellen, dass die richtige Schaltfläche des Aufgabenbereichs nach Abschluss der Navigation hervorgehoben ist.

Beispiele

Der folgende Beispielcode zeigt, wie NavigateTaskPaneURL die URL der Webseite erstellt, die für ServiceTask1 angezeigt werden soll.

Beispiel für das Navigate-Element :

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

Beispielaufruf der NavigateTaskPaneURL-Methode :

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

Beispiel für die resultierende URL, die für die in ServiceTask1 angezeigte Webseite verwendet wird:

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

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe 10 oder höher
DLL	Wmp.dll

Siehe auch

Externes Objekt für Onlineshops vom Typ 2

External.SelectedTaskPane