MediaCollection.getByName-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 getByName-Methode ruft eine Wiedergabeliste der Medienelemente mit dem angegebenen Namen ab.
Syntax
retVal = MediaCollection.getByName(
name
)
Parameter
-
Name [in]
-
Zeichenfolge , die den Namen enthält.
Rückgabewert
Diese Methode gibt ein Playlist-Objekt zurück.
Bemerkungen
Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.
Beispiele
Im folgenden JScript-Beispiel wird MediaCollection verwendet. getByName , um drei Elemente aus der Bibliothek abzurufen. Jedes Element wird dann an die aktuelle Wiedergabeliste angefügt. Das Player-Objekt wurde mit ID="Player" erstellt.
// In each case, use the name exactly as it appears in the library.
// Windows Media Player does not include file name extensions or file paths
// in the name. Internet URLs include the entire path, but not the
// file name extension.
// Get a playlist object that contains an Internet URL.
var One = Player.mediaCollection.getByName("https://www.proseware.com/Media/Laure");
// Get a playlist object that contains a file on a network server.
var Two = Player.mediaCollection.getByName("Jeanne");
// Get a playlist object that contains a file on a local drive.
var Three = Player.mediaCollection.getByName("house");
// Append each item to the current playlist. Since each playlist retrieved
// using getByName contains one digital media item, use Playlist.item with
// an index of zero to reference that item.
Player.currentPlaylist.appendItem(One.item(0));
Player.currentPlaylist.appendItem(Two.item(0));
Player.currentPlaylist.appendItem(Three.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