Método Media.isReadOnlyItem

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método isReadOnlyItem devuelve un valor que indica si se puede editar el atributo especificado del elemento multimedia.

Sintaxis

bRetVal = Media.isReadOnlyItem(
  attribute
)

Parámetros

atributo [in]

Cadena que indica el nombre del atributo que se va a probar. Para obtener información sobre los atributos admitidos por Reproductor multimedia de Windows, vea la referencia de atributos de Reproductor multimedia de Windows.

Valor devuelto

Este método devuelve un valor booleano.

Observaciones

Si un atributo es de solo lectura, no se puede establecer con el método setItemInfo . Tenga en cuenta que este método puede devolver valores diferentes para un atributo determinado cuando se usa con versiones diferentes de Reproductor multimedia de Windows.

Para usar este método, se requiere acceso de lectura a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.

Reproductor multimedia de Windows 10 Mobile: esta propiedad siempre devuelve true.

Ejemplos

En el ejemplo siguiente de JScript se usa Media. isReadOnlyItem para rellenar un elemento TEXTAREA HTML denominado rwText con información sobre el elemento multimedia actual. El código genera cada atributo del elemento multimedia actual, junto con texto que indica si el atributo es de solo lectura o de lectura y escritura. El objeto Player se creó con 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	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Media (objeto)

Media.setItemInfo

Settings.mediaAccessRights

Settings.requestMediaAccessRights