Método Media.isMemberOf

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método isMemberOf devuelve un valor que indica si el elemento multimedia es miembro de la lista de reproducción especificada.

Sintaxis

bRetVal = Media.isMemberOf(
  playlist
)

Parámetros

lista de reproducción [in]

Objeto de lista de reproducción que puede contener el elemento multimedia.

Valor devuelto

Este método devuelve un valor Boolean.

Observaciones

Este método no puede comprobar las listas de reproducción recuperadas a través del objeto MediaCollection . Para probar si un elemento multimedia es miembro de una lista de reproducción con nombre determinada, recupere la lista de reproducción con el reproductor. playlistCollection. getByName(name). item(0). Este método también se puede usar con listas de reproducción de CD y listas de reproducción de metarchivo.

Para usar este método, se requiere acceso de lectura a la biblioteca. Para obtener más información, vea Acceso a bibliotecas.

Ejemplos

En el siguiente ejemplo de JScript se usa Media. isMemberOf para probar si el elemento multimedia actual es miembro de la lista de reproducción denominada Lista de reproducción de ejemplo. Si no es así, el elemento multimedia actual se anexa a la lista de reproducción de ejemplo. El objeto Player se creó con id. = "Player".

// 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);
}

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Objeto Media

Objeto Playlist

PlaylistCollection (objeto)

Settings.mediaAccessRights

Settings.requestMediaAccessRights