Media.isReadOnlyItem-Methode

Die isReadOnlyItem-Methode gibt einen Wert zurück, der angibt, ob das angegebene Attribut des Medienelements bearbeitet werden kann.

Syntax

bRetVal = Media.isReadOnlyItem(
  attribute
)

Parameter

-Attribut [ In]

Zeichenfolge, die den Namen des zu testden Attributs angibt. Informationen zu den attributen, die von Windows Media Player unterstützt werden, finden Sie in der Windows Media Player Attributreferenz.

Rückgabewert

Diese Methode gibt einen booleschen wert zurück.

Hinweise

Wenn ein Attribut schreibgeschützt ist, kann es nicht mit der setItemInfo-Methode festgelegt werden. Beachten Sie, dass diese Methode möglicherweise unterschiedliche Werte für ein bestimmtes Attribut zurückgibt, wenn sie mit verschiedenen Versionen von Windows Media Player verwendet wird.

Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Windows Media Player 10 Mobile: Diese Eigenschaft gibt immer true zurück.

Beispiele

Im folgenden JScript Beispiel wird Media verwendet. isReadOnlyItem, um ein HTML TEXTAREA-Element namens rwText mit Informationen zum aktuellen Medienelement zu füllen. Der Code gibt jedes Attribut des aktuellen Medienelements zusammen mit Text aus, der angibt, ob das Attribut schreibgeschützt oder lese-/schreibgeschützt ist. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// 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";
}

Anforderungen

Anforderung Wert
Version
Windows Media Player Version 7.0 oder höher.
DLL
Wmp.dll

Weitere Informationen

Medienobjekt

Media.setItemInfo

Einstellungen.mediaAccessRights

Einstellungen.requestMediaAccessRights