Metodo External.cancelNavigate

[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 cancelNavigate informa Lettore multimediale Windows che non deve visualizzare una nuova pagina di individuazione anche se la visualizzazione è stata modificata in Player.

Sintassi

External.cancelNavigate()

Parametri

Questo metodo non presenta parametri.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Quando la visualizzazione cambia in Lettore multimediale Windows, il giocatore chiama il plug-in del negozio online per determinare quale pagina di individuazione visualizzare successivamente. In alcuni casi, tuttavia, lo store online potrebbe volere che il lettore continui a visualizzare la pagina di individuazione esistente. Il processo seguente determina se il lettore visualizza una nuova pagina di individuazione:

1. Un'azione da parte dell'utente, nell'interfaccia utente del giocatore o nella pagina di individuazione, richiede che il giocatore modifi la visualizzazione.
2. Il lettore chiama il metodo GetTemplate del plug-in per determinare quale pagina di individuazione visualizzare successivamente. Il lettore archivia l'URL della nuova pagina di individuazione, ma non visualizza la nuova pagina di individuazione in questo momento.
3. Il lettore genera l'evento OnViewChange .
4. Se il gestore eventi OnViewChange nella pagina di individuazione chiama cancelNavigate, il lettore non visualizza la nuova pagina di individuazione (determinata nel passaggio 2). Continua invece a visualizzare la pagina di individuazione esistente. Se il gestore eventi OnViewChange non chiama cancelNavigate, il lettore visualizza la nuova pagina di individuazione.

Si supponga, ad esempio, che player visualizzi attualmente la visualizzazione di un album con una determinata traccia selezionata. Si supponga inoltre che la pagina di individuazione corrente sia la pagina che rappresenta l'intero album. Se l'utente fa clic su una traccia diversa dallo stesso album, la visualizzazione del lettore cambia leggermente per mostrare che la nuova traccia è selezionata. Non è tuttavia necessario visualizzare una nuova pagina di individuazione. La pagina di individuazione che rappresenta l'intero album è ancora la pagina appropriata per la visualizzazione del lettore.

Requisiti

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

Vedi anche

Oggetto esterno per gli archivi online di tipo 1

External.changeViewOnlineList

External.OnViewChange