MediaCollection.getByName-Methode

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.

Hinweise

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. getByName zum Abrufen von drei Elementen aus der Bibliothek. 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 Media Player Version 7.0 oder höher.
DLL
Wmp.dll

Siehe auch

MediaCollection-Objekt

Wiedergabelistenobjekt

Einstellungen.mediaAccessRights

Einstellungen.requestMediaAccessRights