Método External.cancelNavigate

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Observação

Este tópico descreve a funcionalidade projetada para uso por lojas online. Não há suporte para o uso dessa funcionalidade fora do contexto de um repositório online.

O método cancelNavigate informa Reprodutor Multimídia do Windows que ele não deve exibir uma nova página de descoberta, mesmo que a exibição tenha sido alterada no Player.

Sintaxe

External.cancelNavigate()

Parâmetros

Esse método não tem parâmetros.

Retornar valor

Esse método não retorna um valor.

Comentários

Quando a exibição é alterada no Reprodutor Multimídia do Windows, o Player chama o plug-in da loja online para determinar qual página de descoberta exibir a seguir. Em alguns casos, no entanto, a loja online pode querer que o Player continue exibindo a página de descoberta existente. O processo a seguir determina se o Player exibe uma nova página de descoberta:

1. Uma ação do usuário, seja na interface do usuário do Player ou na página de descoberta, solicita que o Player altere sua exibição.
2. O Player chama o método GetTemplate do plug-in para determinar qual página de descoberta exibir a seguir. O Player armazena a URL da nova página de descoberta, mas não exibe a nova página de descoberta no momento.
3. O Player aciona o evento OnViewChange .
4. Se o manipulador de eventos OnViewChange na página de descoberta chamar cancelNavigate, o Player não exibirá a nova página de descoberta (determinada na etapa 2). Em vez disso, ele continua a exibir a página de descoberta existente. Se o manipulador de eventos OnViewChange não chamar cancelNavigate, o Player exibirá a nova página de descoberta.

Por exemplo, suponha que o Player esteja exibindo atualmente a exibição de um álbum com uma determinada faixa selecionada. Suponha também que a página de descoberta atual seja a página que representa todo o álbum. Se o usuário clicar em uma faixa diferente do mesmo álbum, a exibição do Player mudará ligeiramente para mostrar que a nova faixa está selecionada. Mas não é necessário exibir uma nova página de descoberta. A página de descoberta que representa todo o álbum ainda é a página apropriada para o Player exibir.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows 11.
DLL	Wmp.dll

Confira também

Objeto externo para repositórios online do tipo 1

External.changeViewOnlineList

External.OnViewChange