Media.isReadOnlyItem-Methode
[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
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 testenden Attributs angibt. Informationen zu den von Windows Medienwiedergabe unterstützten Attributen finden Sie in der Windows Medienwiedergabe-Attributreferenz.
Rückgabewert
Diese Methode gibt einen Booleschen Wert zurück.
Bemerkungen
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 Medienwiedergabe verwendet wird.
Um diese Methode verwenden zu können, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.
Windows Medienwiedergabe 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 Medienwiedergabe Version 7.0 oder höher. |
DLL |
|
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für