Método Media.setItemInfo

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

O método setItemInfo define o valor do atributo especificado para o item de mídia atual.

Sintaxe

Media.setItemInfo(
  attribute,
  value
)

Parâmetros

atributo [in]

Cadeia de caracteres que contém o nome do atributo. Para obter informações sobre os atributos compatíveis com Reprodutor Multimídia do Windows, consulte a Referência de Atributo Reprodutor Multimídia do Windows.

value [in]

Cadeia de caracteres que contém o novo valor.

Retornar valor

Esse método não retorna um valor.

Comentários

A propriedade attributeCount contém o número de atributos disponíveis para um determinado objeto Media . Os números de índice podem ser usados com o método getAttributeName para determinar os nomes dos atributos internos que podem ser usados com esse método.

Antes de usar esse método, use o método isReadOnlyItem para determinar se um atributo específico pode ser definido.

Para usar esse método, é necessário acesso completo à biblioteca. Para obter mais informações, consulte Acesso à biblioteca.

Observação

Se você inserir o controle Reprodutor Multimídia do Windows em seu aplicativo, os atributos de arquivo alterados não serão gravados no arquivo de mídia digital até que o usuário execute Reprodutor Multimídia do Windows. Se você usar o controle em um aplicativo remoto escrito em C++, os atributos de arquivo alterados serão gravados no arquivo de mídia digital logo após você fazer as alterações. Em ambos os casos, as alterações estão imediatamente disponíveis para seu código por meio da biblioteca.

Reprodutor Multimídia do Windows 10 Mobile: esse método não é implementado.

Exemplos

O exemplo JScript a seguir usa Mídia. setItemInfo para alterar o valor do atributo Gênero para o item de mídia atual. Um elemento de entrada HTML TEXT chamado genText permite que o usuário insira uma cadeia de caracteres de texto, que é usada para alterar as informações de atributo. O objeto Player foi criado com ID = "Player".

<!-- Create the button element. -->
<INPUT type = "BUTTON"  id = "NEWGEN"  name = "NEWGEN"  value = "Change Genre" 
onClick = "
    /* Store the current media item. */
    var cm = Player.currentMedia;

    /* Get the user input from the text box. */
    var atValue = genText.value;

    /* Test for read-only status of the attribute. */
    if(cm.isReadOnlyItem('Genre') == false){

        /* Change the attribute value. */
        cm.setItemInfo('Genre' ,atValue);
    } 
">

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Objeto Media

Media.getItemInfo

Media.isReadOnlyItem

Settings.mediaAccessRights

Settings.requestMediaAccessRights