Método Media.isReadOnlyItem

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 diferentes versiones 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 de JScript siguiente 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

Configuración.mediaAccessRights

Configuración.requestMediaAccessRights