Media.isMemberOf-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 isMemberOf-Methode gibt einen Wert zurück, der angibt, ob das Medienelement ein Element der angegebenen Wiedergabeliste ist.

Syntax

bRetVal = Media.isMemberOf(
  playlist
)

Parameter

Wiedergabeliste [in]

Wiedergabelistenobjekt , das möglicherweise das Medienelement enthalten kann.

Rückgabewert

Diese Methode gibt einen booleschen Wert zurück.

Bemerkungen

Diese Methode kann keine Wiedergabelisten überprüfen, die über das MediaCollection-Objekt abgerufen werden. Um zu testen, ob ein Medienelement Mitglied einer bestimmten benannten Wiedergabeliste ist, rufen Sie die Wiedergabeliste mit dem Player ab. playlistCollection. getByName(name). item(0). Diese Methode kann auch mit CD-Wiedergabelisten und Metafile-Wiedergabelisten verwendet werden.

Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Beispiele

Im folgenden JScript-Beispiel wird Media verwendet. isMemberOf , um zu testen, ob das aktuelle Medienelement ein Mitglied der Wiedergabeliste mit dem Namen Sample Playlist ist. Andernfalls wird das aktuelle Medienelement an die Beispielwiedergabeliste angefügt. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// Store the playlist object named Sample Playlist.
var sPlaylist = Player.playlistcollection.getbyname("Sample Playlist").item(0);

// Test whether the current media item is a member of Sample Playlist.
 var answer = ((Player.currentMedia.isMemberOf(sPlaylist))?"Yes":"No");

// If the current media item is not a member of Sample Playlist,
// append the current media item to the playlist.
if (answer == "No"){
   sPlaylist.appendItem(Player.currentMedia);
}

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

Medienobjekt

Wiedergabelistenobjekt

PlaylistCollection-Objekt

Settings.mediaAccessRights

Settings.requestMediaAccessRights