Metodo External.changeView

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché 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

Questo argomento descrive le funzionalità progettate per l'uso da parte degli archivi online. L'uso di questa funzionalità al di fuori del contesto di un archivio online non è supportato.

Il metodo changeView modifica la visualizzazione in Lettore multimediale Windows.

Sintassi

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

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 genere specifico.

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. Vedere la sezione Osservazioni.

Filtro [in]

Stringa contenente il filtro per la nuova visualizzazione. La visualizzazione verrà filtrata come se l'utente avesse immesso questo testo nel controllo della rotellina della parola del giocatore. Questa stringa può essere vuota.

ViewParams [in]

Stringa contenente parametri che Lettore multimediale Windows rende disponibili per la nuova pagina di individuazione visualizzata con la nuova visualizzazione. Questi parametri non vengono interpretati da Lettore multimediale Windows. Vengono creati dallo store online e hanno significato solo per il negozio online.

Valore restituito

Questo metodo non restituisce valori.

Commenti

In alcuni casi, è consigliabile impostare il parametro LibraryLocationID sulla stringa vuota. Ad esempio, se si imposta il parametro LibraryLocationType su AllCPAlbumIDs, la nuova visualizzazione rappresenta tutti gli album. Nessun singolo album sarà lo stato attivo della nuova visualizzazione, quindi non è necessario specificare un ID album nel parametro LibraryLocationID .

Il parametro ViewParams consente a una pagina di individuazione di comunicare con un'altra pagina di individuazione. Quando lo script in una pagina di individuazione chiama changeView, Lettore multimediale Windows modifica l'interfaccia utente. Questa regolazione causa la chiamata del metodo IWMPContentPartner::GetTemplate al metodo Player per ottenere l'URL di una nuova pagina di individuazione. La stringa che la pagina di individuazione originale passa nel parametro ViewParams non viene passata a GetTemplate. Tuttavia, la nuova pagina di individuazione può recuperare la stringa ViewParams chiamando External.viewParameters.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows 11.
DLL	Wmp.dll

Vedi anche

Oggetto esterno per i tipi 1 archivi online

External.changeViewOnlineList

External.libraryLocationID

External.libraryLocationType

External.viewParameters