Metodo External.changeViewOnlineList

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota

In questo argomento vengono descritte le funzionalità progettate per l'uso da parte di negozi online. L'uso di questa funzionalità al di fuori del contesto di un negozio online non è supportato.

Il metodo changeViewOnlineList modifica la visualizzazione in Lettore multimediale Windows per visualizzare un elenco generato dinamicamente dall'archivio online.

Sintassi

External.changeViewOnlineList(
  LibraryLocationType,
  LibraryLocationID,
  Params,
  FriendlyName,
  ListType,
  ViewMode
)

Parametri

LibraryLocationType [in]

Costante della posizione della libreria che specifica il tipo della nuova visualizzazione. Ad esempio, la costante CPGenreID specifica che la nuova visualizzazione mostrerà un particolare genere.

LibraryLocationID [in]

Stringa contenente l'ID dell'elemento specifico da visualizzare nella nuova visualizzazione. Ad esempio, se LibraryLocationType è CPGenreID, questo parametro specifica l'ID del genere da visualizzare nella nuova visualizzazione. Questa stringa può essere vuota.

Parametri [in]

Stringa contenente parametri che Lettore multimediale Windows passano al plug-in del negozio online chiamando IWMPContentPartner::GetTemplate. Questi parametri non vengono interpretati da Lettore multimediale Windows. Vengono creati dal negozio online e hanno significato solo per lo store online. Questa stringa può essere vuota

FriendlyName [in]

Stringa contenente un nome descrittivo, da visualizzare da Lettore multimediale Windows, per l'elenco dinamico.

ListType [in]

Costante della posizione della libreria che specifica il tipo degli elementi nell'elenco generato in modo dinamico. Ad esempio, se il valore di questo parametro è CPTrackID, l'elenco dinamico conterrà tracce.

ViewMode [in]

Stringa che specifica la modalità che Lettore multimediale Windows userà per visualizzare l'elenco dinamico. Il chiamante deve impostare questo parametro su uno dei valori seguenti, definiti in contentpartner.h:

ViewModeReport

ViewModeDetails

ViewModeIcon

ViewModeTile

ViewModeOrderedList

Valore restituito

Questo metodo non restituisce valori.

Commenti

Quando lo script in una pagina di individuazione chiama changeViewOnlineList, Lettore multimediale Windows passa alcuni parametri insieme ai metodi IWMPContentPartner::GetListContents e IWMPContentPartner::GetTemplate, implementati dal plug-in dello store online. Nella tabella seguente viene illustrata la corrispondenza tra i parametri dei tre metodi.

parametro changeViewOnlineList	Parametro GetListContents	Parametro GetTemplate
LocationType	location	location
LocationID	pContext	pContext
Params	bstrParams	bstrViewParams
ListType	bstrListType	non applicabile

Poiché tutti e tre i metodi illustrati nella tabella precedente vengono implementati dall'archivio online, è possibile usare i parametri in modo flessibile. L'idea è che si forniscono informazioni sufficienti per GetListContents per determinare l'elenco da recuperare e per GetTemplate per determinare la pagina di individuazione da visualizzare successivamente. Gli esempi seguenti illustrano due possibilità.

Esempio 1: elenco dinamico che si trova nel catalogo dello store online

Si supponga di voler ottenere il contenuto dell'elenco dinamico con ID 6 nel catalogo dello store online. Si supponga che l'elenco 6 sia un elenco di tracce. È possibile fornire al plug-in informazioni sufficienti effettuando la chiamata seguente.

external.changeViewOnlineList(
   "CPListID", 6, "", 
   "Songs for Today", "CPTrackID", "ViewModeDetails");

Si noti che il parametro Params è vuoto; il plug-in contiene informazioni sufficienti negli altri parametri.

Esempio 2: elenco dinamico che non si trova nel catalogo dello store online

Si supponga di voler ottenere il contenuto di un elenco dinamico che non si trova nel catalogo dello store online. Forse hai deciso di avere un elenco dinamico che include canzoni selezionate da un particolare artista. Si supponga che l'artista abbia un ID 2 nel catalogo del negozio online. È possibile effettuare la chiamata seguente.

external.changeViewOnlineList(
   "CPArtistID", 2, "songs picked by Sally", 
   "Sally Picks", "CPTrackID", "ViewModeDetails");

Si noti che i parametri LocationType e LocationID non specificano l'elenco. Il parametro Params specifica invece l'elenco. I parametri LocationType e LocationID vengono passati a IWMPContentPartner::GetListContents, ma in questo caso GetListContents possono ignorarli. I parametri LocationType e LocationID vengono passati anche a IWMPContentPartner::GetTemplate, che possono essere usati per determinare la pagina di individuazione da visualizzare con l'elenco dinamico.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows 11
DLL	Wmp.dll

Vedi anche

Oggetto esterno per gli archivi online di tipo 1

IWMPContentPartner::GetListContents

IWMPContentPartnerCallback::AddListContents

IWMPContentPartner::GetTemplate

Posizione e elemento selezionato