External.changeView-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 changeView-Methode ändert die Ansicht in Windows Media Player.

Syntax

External.changeView(
  LibraryLocationType,
  LibraryLocationID,
  Filter,
  ViewParams
)

Parameter

LibraryLocationType [ In]

Eine Bibliotheksspeicherort-Konstante, die den Typ der neuen Ansicht angibt. Beispielsweise gibt die Konstante CPGenreID an, dass die neue Ansicht ein bestimmtes Genre zeigt.

LibraryLocationID [ In]

Eine Zeichenfolge, die die ID des bestimmten Elements enthält, das in der neuen Ansicht angezeigt werden soll. Wenn LibraryLocationType beispielsweise CPGenreID ist, gibt dieser Parameter die ID des Genre an, das in der neuen Ansicht angezeigt werden soll. Diese Zeichenfolge kann leer sein. Siehe Hinweise.

Filter [ In]

Eine Zeichenfolge, die den Filter für die neue Sicht enthält. Die Ansicht wird gefiltert, als ob der Benutzer diesen Text in das Wortrad-Steuerelement des Players eingegeben hätte. Diese Zeichenfolge kann leer sein.

ViewParams [ In]

Zeichenfolge mit Parametern, Windows Media Player der neuen Ermittlungsseite zur Verfügung gestellt werden, die mit der neuen Ansicht angezeigt wird. Diese Parameter werden von der -Windows Media Player. Sie werden vom Onlineshop erstellt und haben nur eine Bedeutung für den Onlineshop.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Hinweise

In einigen Fällen ist es sinnvoll, den LibraryLocationID-Parameter auf die leere Zeichenfolge zu setzen. Wenn Sie beispielsweise den Parameter LibraryLocationType auf AllCPTeriIDs festlegen, stellt die neue Ansicht alle Albums dar. Kein einzelnes Album wird der Fokus der neuen Ansicht sein, sodass im Parameter LibraryLocationID keine Album-ID angegeben werden muss.

Der ViewParams-Parameter bietet einer Ermittlungsseite die Möglichkeit, mit einer anderen Ermittlungsseite zu kommunizieren. Wenn das Skript auf einer Ermittlungsseite changeView aufruft, Windows Media Player Die Benutzeroberfläche wird angepasst. Diese Anpassung bewirkt, dass der Player die IWMPContentPartner::GetTemplate-Methode des Plug-Ins aufruft, um die URL einer neuen Ermittlungsseite zu erhalten. Die Zeichenfolge, die die ursprüngliche Ermittlungsseite im ViewParams-Parameter übergibt, wird nicht an GetTemplate übergeben. Die neue Ermittlungsseite kann jedoch die ViewParams-Zeichenfolge abrufen, indem External.viewParameters aufgerufen wird.

Anforderungen

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

Siehe auch

Externes Objekt für Onlinespeicher vom Typ 1

External.changeViewOnlineList

External.libraryLocationID

External.libraryLocationType

External.viewParameters