Compartilhar via


Usando o controle Reprodutor Multimídia do Windows com o Visual Basic

[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.]

Esta seção descreve como usar o controle ActiveX Reprodutor Multimídia do Windows série 9 ou posterior em aplicativos criados com o Microsoft Visual Basic 6.0.

Introdução

Para adicionar o controle Reprodutor Multimídia do Windows à caixa de ferramentas, primeiro selecione Componentes no menu Projeto. Na caixa de diálogo Componentes, selecione a caixa marcar ao lado de "Reprodutor Multimídia do Windows". Na parte inferior da caixa de diálogo, confirme se o arquivo selecionado está wmp.dll. Depois de fechar a caixa de diálogo, você pode colocar uma instância do controle Reprodutor Multimídia do Windows em seu formulário das maneiras usuais.

Você pode definir muitas propriedades de controle usando o janela Propriedades. Para definir algumas propriedades, você deve usar a caixa de diálogo Propriedades Reprodutor Multimídia do Windows, que você abre usando o item "(Personalizado)" no janela Propriedades.

Referências de objeto

Você usa determinadas propriedades de controle player para obter referências a objetos específicos. Por exemplo, a propriedade cdromCollection retorna uma referência a um objeto CdromCollection . Você deve atribuir essa referência a uma variável que você declarou como a interface correspondente. No caso da propriedade cdromCollection , por exemplo, você atribui seu valor retornado a uma variável do tipo IWMPCdromCollection.

Leia o tópico Interfaces na Referência de Modelo de Objeto para C++ para identificar quais objetos implementam várias interfaces. Nesses casos, você deve declarar uma variável de objeto como a interface com maior número documentada neste SDK para ter acesso a todas as propriedades e métodos desse objeto. Por exemplo, você deve atribuir o valor da propriedade Reprodutor Multimídia do Windows control currentMedia a uma variável declarada como IWMPMedia3 para garantir que você tenha acesso aos métodos getAttributeCountByType e getItemInfoByType.

Observação

O objeto WindowsMediaPlayer implementa todas as propriedades e métodos das interfaces IWMPCore, IWMPCore2, IWMPCore3, IWMPPlayer, IWMPPlayer2, IWMPPlayer3 e IWMPPlayer4 . Você não precisa declarar variáveis separadas para nenhuma dessas interfaces. Você pode acessar todos os membros usando o nome atribuído à instância do WindowsMediaPlayer .

 

No Visual Basic Object Browser, você verá muitas interfaces destinadas ao uso privado pelo controle Reprodutor Multimídia do Windows, incluindo algumas que dão suporte a desenvolvedores de skin. Você deve usar apenas os objetos, propriedades, métodos e eventos documentados neste SDK.

Dicas Adicionais

  • A documentação de referência mostra a sintaxe JScript. No JScript, os argumentos passados para métodos são sempre colocados entre parênteses. No Visual Basic 6.0, os argumentos passados para métodos que não retornam um valor não devem ser colocados entre parênteses.

  • Algumas propriedades ou métodos podem não aparecer no recurso preenchimento de código da Lista Automática no editor de código do Visual Basic. Você ainda pode usar esses membros digitando seus nomes exatamente como eles aparecem nesta documentação.

  • Gerencie a aparência visual do controle usando a propriedade uimode . Você pode fazer isso de duas maneiras. Você pode usar a lista suspensa Selecionar um modo na caixa de diálogo Propriedades do Reprodutor Multimídia do Windows ou digitar o valor correto no janela Propriedades.

    Em particular, não use a propriedade visível para ocultar o controle; em vez disso, atribua o valor "invisible" à propriedade uimode .

Guia de Controle do Player