Compartilhar via


Elemento argument

[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 elemento argument contém uma parte de uma cadeia de caracteres de condição. Uma cadeia de caracteres de condição normalmente tem uma parte de condição e uma parte de valor. Por exemplo, na cadeia de caracteres de condição "Artist Equals Joe", a parte da condição é "Equals" e a parte do valor é "Joe".

<argument
   name = "string"
>
   string
</argument>
        

Atributos

name (obrigatório)

O nome de uma parte da cadeia de caracteres de condição.

Elementos pai/filho

Hierarquia Elementos
Parent Fragmento
Filho Nenhum

Comentários

Quando o atributo name de um elemento de fragmento é uma característica de item de mídia, como Artista de Álbum ou Gênero, o elemento fragmento deve conter dois elementos de argumento : um que especifica uma condição e outro que especifica um valor. A tabela a seguir mostra dois valores possíveis para o atributo name e como os elementos de argumento são usados para especificar condições e valores.

Valor do atributo Descrição
Condição O conteúdo do elemento argumento é a parte de condição de uma cadeia de caracteres de condição. Por exemplo, na cadeia de caracteres de condição "Artist Equals Joe", a parte da condição é "Equals". A parte de condição de uma cadeia de caracteres de condição deve ser uma das seguintes: Equals, Does Not Equal, Contains, Does Not Contain, Is Less Than, Is, Is, Is Not, Is Before, Is Later Than, Is More Recent Than, Above, Below, Ascending, Descending, Random, Is No Least, Is No More Than.
Valor O conteúdo do elemento argumento é a parte de valor de uma cadeia de caracteres de condição. Por exemplo, na cadeia de caracteres de condição "Artist Equals Joe", a parte do valor é "Joe". Exemplo:
\<fragment name = "Artist">
  <argument name = "Condition">Equals</argument>
  <argument name = "Value">Joe</argument>
</fragment>

Quando o atributo name de um elemento de fragmento for "Limitar Tamanho Total a" ou "Limitar Duração Total a", o elemento de fragmento deverá conter dois elementos de argumento : um que especifica um formato e outro que especifica um número. A tabela a seguir mostra dois valores possíveis para o atributo name e como os elementos de argumento são usados para limitar o tamanho ou a duração de uma playlist.

Valor do atributo Descrição
Formatar Quando o atributo name do elemento fragment é "Limit Total Size To", o conteúdo do elemento argumento deve ser um dos seguintes: Kilobytes, Megabytes ou Gigabytes.Quando o atributo name do elemento de fragmento for "Limitar duração total a", o conteúdo do elemento argumento deve ser um dos seguintes: Seconds, Minutes, Hours, ou Dias.
Número O conteúdo do elemento argumento é um número que limita o tamanho ou a duração da playlist. Exemplos:
\<fragment name = "Limit Total Size To"><argument name = "Format">Megabytes</argument><argument name = "Number">5</argument></fragment>

<fragment name = "Limit Total Duration To"> <argument name = "Format">Minutes</argument> <argument name = "Number">20</argument> </fragment>

Quando o atributo name de um elemento de fragmento é "Limit Number of Items", o elemento fragment deve conter um elemento de argumento que especifica o número de itens. A tabela a seguir mostra como usar o valor Número do atributo name .

Valor do atributo Descrição
Número O conteúdo do elemento argumento é um número que limita o número de itens em uma playlist. Exemplo:
\<fragment name = "Limit Number of Items">
  <argument name = "Number">15</argument>
</fragment>

Requisitos

Requisito Valor
Versão
Reprodutor Multimídia do Windows série 9 ou posterior.

Consulte também

Elemento fragment

Referência de elementos de playlist do Windows Media