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:
- Eine Aktion des Benutzers, entweder auf der Benutzeroberfläche des Players oder auf der Ermittlungsseite, fordert an, dass der Player seine Ansicht ändert.
- 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.
- Der Player löst das OnViewChange-Ereignis aus.
- 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 |
|