Método Media.isReadOnlyItem

[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 isReadOnlyItem retorna um valor que indica se o atributo especificado do item de mídia pode ser editado.

Sintaxe

bRetVal = Media.isReadOnlyItem(
  attribute
)

Parâmetros

atributo [in]

Cadeia de caracteres que indica o nome do atributo a ser testado. 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..

Retornar valor

Esse método retorna um booliano.

Comentários

Se um atributo for somente leitura, ele não poderá ser definido com o método setItemInfo . Observe que esse método pode retornar valores diferentes para um atributo específico quando usado com diferentes versões de Reprodutor Multimídia do Windows.

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

Reprodutor Multimídia do Windows 10 Mobile: essa propriedade sempre retorna true.

Exemplos

O exemplo de JScript a seguir usa Mídia. isReadOnlyItem para preencher um elemento TEXTAREA HTML chamado rwText com informações sobre o item de mídia atual. O código gera cada atributo do item de mídia atual, juntamente com o texto indicando se o atributo é somente leitura ou leitura/gravação. O objeto Player foi criado com ID = "Player".

// Store the current media item object.
var cm = Player.currentMedia;

// Create a variable to hold each attribute name.
var atName;

// Loop through the attribute list.
for(var i = 0; i < cm.attributeCount; i++){

   // Get the attribute name.
   atName = cm.getAttributeName(i);

   // Test whether the attribute is read-only.
   var test = ((cm.isReadOnlyItem(atName))?"Read-Only":"Read/Write");

// Print the attribute information to the text area.
   rwText.value += atName + " is " + test;
   rwText.value += "\n";
}

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.setItemInfo

Settings.mediaAccessRights

Settings.requestMediaAccessRights