Méthode Media. isReadOnlyItem

La méthode isReadOnlyItem retourne une valeur indiquant si l’attribut spécifié de l’élément multimédia peut être modifié.

Syntaxe

bRetVal = Media.isReadOnlyItem(
  attribute
)

Paramètres

attribut [ dans]

Chaîne indiquant le nom de l’attribut à tester. pour plus d’informations sur les attributs pris en charge par Lecteur Windows Media, consultez la référence d’attributLecteur Windows Media.

Valeur de retour

Cette méthode retourne une valeur booléenne.

Notes

Si un attribut est en lecture seule, il ne peut pas être défini à l’aide de la méthode setItemInfo . notez que cette méthode peut retourner des valeurs différentes pour un attribut particulier lorsqu’elle est utilisée avec différentes versions de Lecteur Windows Media.

Pour utiliser cette méthode, l’accès en lecture à la bibliothèque est requis. Pour plus d’informations, consultez accès à la bibliothèque.

Lecteur Windows Media 10 Mobile : Cette propriété retourne toujours true.

Exemples

l’exemple de JScript suivant utilise un média. isReadOnlyItem pour remplir un élément textarea html nommé rwText avec des informations sur l’élément multimédia actuel. Le code génère chaque attribut de l’élément multimédia en cours, ainsi que le texte indiquant si l’attribut est en lecture seule ou en lecture/écriture. L’objet Player a été créé avec 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";
}

Configuration requise

Condition requise Valeur
Version
Lecteur Windows Media version 7,0 ou ultérieure.
DLL
Wmp.dll

Voir aussi

Objet Media

Media. setItemInfo

Paramètres. mediaAccessRights

Paramètres. requestMediaAccessRights