Método External.showPopup

[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 showPopup instrui Reprodutor Multimídia do Windows a exibir uma página da Web pop-up; ou seja, uma página da Web que aparece em uma janela separada.

Sintaxe

External.showPopup(
  PopupIndex,
  Parameters
)

Parâmetros

PopupIndex [in]

Número (long) que especifica o índice da página da Web pop-up.

Parâmetros [in]

Cadeia de caracteres que Reprodutor Multimídia do Windows acrescenta à URL da página da Web.

Retornar valor

Esse método não retorna um valor.

Comentários

O índice pop-up não é interpretado por Reprodutor Multimídia do Windows. Os índices que identificam páginas da Web pop-up são criados pelo repositório online e têm significado apenas para o repositório online.

As etapas a seguir mostram como Reprodutor Multimídia do Windows usa os parâmetros do método showPopup para criar uma URL para a janela pop-up.

1. O script em uma página de descoberta chama showPopup, passando um inteiro em PopupIndex e uma cadeia de caracteres em Parâmetros.

2. Reprodutor Multimídia do Windows passa o índice para IWMPContentPartner::GetItemInfo para recuperar a URL da página da Web a ser exibida.

3. Reprodutor Multimídia do Windows acrescenta Parâmetros à URL como uma cadeia de caracteres de consulta. Por exemplo, se GetItemInfo retornar "https://www.Proseware.com/Pages/Popup1.htm" e Parameters é igual a "DlgX=800&DlgY=400&Greeting=Hi", Reprodutor Multimídia do Windows cria a seguinte URL:

   https://www.Proseware.com/Pages/Popup1.htm?DlgX=800&DlgY=400&Greeting=Hi

Você pode usar Parâmetros para especificar o tamanho da janela pop-up. Por exemplo, se você definir Parâmetros como "DlgX=800&DlgY=400", a janela pop-up terá um tamanho de 800 pixels por 400 pixels.

Requisitos

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

Confira também

Objeto externo para repositórios online tipo 1