MediaCollection.getAttributeStringCollection-Methode
[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die getAttributeStringCollection-Methode ruft ein StringCollection-Objekt ab, das den Satz aller Werte für ein angegebenes Attribut innerhalb eines angegebenen Medientyps darstellt.
Syntax
retVal = MediaCollection.getAttributeStringCollection(
attribute,
mediaType
)
Parameter
-
Attribut [in]
-
Zeichenfolge , die das Attribut angibt.
-
mediaType [in]
-
Zeichenfolge , die den Medientyp darstellt. Enthält einen der folgenden Werte: "Audio", "Video", "Wiedergabeliste" oder "Sonstige".
Rückgabewert
Diese Methode gibt ein StringCollection-Objekt zurück.
Hinweise
Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.
Informationen zu den von Windows Medienwiedergabe unterstützten Attributen finden Sie im Abschnitt Attributreferenz.
Beispiele
Im folgenden JScript-Beispiel wird MediaCollection verwendet. getAttributeStringCollection , um eine Liste von Werten anzuzeigen, die einem bestimmten Attribut für Audioelemente in der Mediensammlung entsprechen. Ein MIT ID = "Attribut" erstelltes HTML SELECT-Element ermöglicht es dem Benutzer, ein Attribut wie Künstler, Genre oder Album auszuwählen. Ein HTML TEXTAREA-Element, das mit ID = "AttributeVals" erstellt wurde, zeigt das Ergebnis an. Das Player-Objekt wurde mit der ID = "Player" erstellt.
// Clear the text in the display area.
AttributeVals.value = "";
// Store the mediaCollection object.
var library = Player.mediaCollection;
// Get the string collection for the attribute type the user selects.
var all = library.getAttributeStringCollection(Attribute.value, "Audio");
// Loop through the string collection.
for (i = 0; i < all.count; i++){
// Display the items one line at a time.
AttributeVals.value += all.item(i);
AttributeVals.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