MediaCollection.getByAttribute-Methode
Die getByAttribute-Methode ruft eine Wiedergabeliste von Medienelementen ab, die einen angegebenen Wert für ein angegebenes Attribut enthalten.
Syntax
retVal = MediaCollection.getByAttribute(
attribute,
value
)
Parameter
-
Attribut [ In]
-
Eine Zeichenfolge, die den Namen des zu durchsuchenden Attributs angibt. Informationen zu den attributes, die von Windows Media Player unterstützt werden, finden Sie in der Windows Media Player Attribute Reference.
-
value [ In]
-
Eine Zeichenfolge, die den Wert angibt, über den das Attribut verfügen soll.
Rückgabewert
Diese Methode gibt ein Playlist-Objekt zurück.
Hinweise
Diese Methode kann verwendet werden, um eine generische Abfrage für Medienelemente zu erstellen, die mit einem Wert für ein Attribut in der Datenbank übereinstimmen. Dies ist bei benutzerdefinierten Attributen nützlich. Wenn das Attribut nicht vorhanden ist, tritt ein Fehler auf.
Sie können diese Methode verwenden, um alle Medienelemente eines bestimmten Typs abzurufen. Verwenden Sie den Attributnamen "MediaType" und einen der folgenden Werte:
| Wert | BESCHREIBUNG |
|---|---|
| Audio | Musik und andere Nur-Audio-Elemente. |
| Playlist | Wiedergabelisten, die als Medienobjekte dargestellt werden. |
| radio | Radiostationselemente. Wird von Windows Media Player 10 nicht verwendet. |
| video | Videoelemente. |
| Foto | Fotoelemente. Erfordert Windows Media Player 10. |
| Andere | Andere Elemente, z. B. ASF-Dateien oder URLs für Streamingmedien. |
Um diese Methode verwenden zu können, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.
Beispiele
Im folgenden beispiel JScript MediaCollection verwendet. getByAttribute zum Wiederspielen aller Inhalte aus der Bibliothek durch den Interpreten namens Attributde 48. Das Player-Objekt wurde mit der ID = "Player" erstellt.
// Get a playlist object filled with media items by a
// particular artist.
var pl = Player.mediaCollection.getByAttribute("Artist", "Triode 48");
// Make the new playlist the current one.
Player.currentPlaylist = pl;
// Start Windows Media Player.
Player.controls.play();
Anforderungen
| Anforderung | Wert |
|---|---|
| Version |
Windows Media Player Version 7.0 oder höher. |
| DLL |
|