PlaylistCollection.getByName-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 getByName-Methode ruft ein PlaylistArray-Objekt ab, das Wiedergabelisten mit dem angegebenen Namen enthält, sofern vorhanden.
Syntax
retVal = PlaylistCollection.getByName(
name
)
Parameter
-
Name [in]
-
Zeichenfolge , die den Namen der abzurufenden Wiedergabelisten enthält.
Rückgabewert
Diese Methode gibt ein PlaylistArray-Objekt zurück.
Bemerkungen
Verwenden Sie PlaylistArray. count , um zu bestimmen, ob eine Wiedergabeliste vorhanden ist. Wenn die Anzahl null ist, ist keine Wiedergabeliste vorhanden.
Um diese Methode verwenden zu können, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.
Beispiele
Im folgenden JScript-Beispiel wird playlistCollection verwendet. getByName , um das playlistCollection-Objekt auf eine Wiedergabeliste namens "ThreeList" zu überprüfen. Wenn die Wiedergabeliste "Threelist" vorhanden ist, legt getByName "ThreeList" als aktuelle Wiedergabeliste fest. Das Player-Objekt wurde mit der ID = "Player" erstellt.
//Retrieve the count of the playlists named "ThreeList".
var Checkit = Player.playlistCollection.getByName("ThreeList").count;
//Since duplicate playlist names are allowed, the count returned
//will be either zero (no playlist) or greater than zero
//(playlist exists).
if (Checkit > 0){
//Retrieve a playlistArray object containing "ThreeList". Assume that
//there is only one playlist with that name, and assign it to the
//current playlist.
Player.currentPlaylist = Player.playlistCollection.getByName("ThreeList").item(0);
}
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