External.cancelNavigate-Methode

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 Onlineshops wird nicht unterstützt.

Die cancelNavigate-Methode informiert Windows Media Player, dass keine neue Ermittlungsseite angezeigt werden soll, obwohl sich die Ansicht im Player geändert hat.

Syntax

External.cancelNavigate()

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Hinweise

Wenn sich die Ansicht in Windows Media Player, ruft der Player das Plug-In des Onlineshops auf, um zu bestimmen, welche Ermittlungsseite als Nächstes angezeigt werden soll. In einigen Fällen möchte der Onlineshop jedoch möglicherweise, dass der Player weiterhin die vorhandene Ermittlungsseite anzeigen soll. Der folgende Prozess bestimmt, ob der Player eine neue Ermittlungsseite anzeigt:

  1. Eine Aktion des Benutzers, entweder auf der Benutzeroberfläche des Players oder auf der Ermittlungsseite, fordert an, dass der Player seine Ansicht ändert.
  2. Der Player ruft die GetTemplate-Methode des Plug-Ins auf, um zu bestimmen, welche Ermittlungsseite als Nächstes angezeigt werden soll. Der Player speichert die URL der neuen Ermittlungsseite, aber die neue Ermittlungsseite wird derzeit nicht angezeigt.
  3. Der Player löst das OnViewChange-Ereignis aus.
  4. Wenn der OnViewChange-Ereignishandler auf der Ermittlungsseite cancelNavigate aufruft, zeigt der Player die neue Ermittlungsseite (in Schritt 2 bestimmt) nicht an. Stattdessen wird weiterhin die vorhandene Ermittlungsseite angezeigt. Wenn der OnViewChange-Ereignishandler cancelNavigate nicht aufruft, zeigt der Player die neue Ermittlungsseite an.

Angenommen, der Player zeigt derzeit die Ansicht eines Albums an, für das ein bestimmter Titel ausgewählt ist. Gehen Sie außerdem davon aus, dass die aktuelle Ermittlungsseite die Seite ist, die das gesamte Album darstellt. Wenn der Benutzer auf einen anderen Titel als dasselbe Album klickt, ändert sich die Ansicht des Players geringfügig, um zu zeigen, dass der neue Titel ausgewählt ist. Es ist jedoch nicht notwendig, eine neue Ermittlungsseite anzuzeigen. Die Ermittlungsseite, die das gesamte Album darstellt, ist immer noch die geeignete Seite, auf der der Player angezeigt werden kann.

Anforderungen

Anforderung Wert
Version
Windows Media Player 11.
DLL
Wmp.dll

Siehe auch

Externes Objekt für Onlinespeicher vom Typ 1

External.changeViewOnlineList

External.OnViewChange