Méthode Media.isReadOnlyItem

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

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 [in]

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

Valeur retournée

Cette méthode retourne une valeur Boolean.

Notes

Si un attribut est en lecture seule, il ne peut pas être défini avec 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 multimédia Windows.

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

Lecteur multimédia Windows 10 Mobile : cette propriété retourne toujours true.

Exemples

L’exemple JScript suivant utilise Media. isReadOnlyItem pour remplir un élément HTML TEXTAREA 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 actif, ainsi que du texte indiquant si l’attribut est en lecture seule ou en lecture/écriture. L’objet Player a été créé avec l’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 multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Objet Media

Media.setItemInfo

Settings.mediaAccessRights

Settings.requestMediaAccessRights