Método MediaCollection.getByGenre

[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 getByGenre recupera una lista de reproducción de los elementos multimedia con el género especificado.

Sintaxis

retVal = MediaCollection.getByGenre(
  genre
)

Parámetros

género [in]

Cadena que contiene el nombre del género.

Valor devuelto

Este método devuelve un objeto Playlist .

Observaciones

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

Ejemplos

En el ejemplo siguiente de JScript se usa MediaCollection. getByGenre para recuperar una lista de reproducción de elementos multimedia. La lista de reproducción contiene elementos con el género especificado por el usuario en un elemento de entrada TEXT HTML denominado GetGenre. El objeto Player se creó con id. = "Player".

<!-- Use an HTML BUTTON element to create the playlist and play 
the media items. -->
<INPUT TYPE = "BUTTON"  
       NAME = "PlayGenre"  
       ID = "PlayGenre"  
       VALUE = "Play Genre"

onClick = "
    /* Retrieve the genre text from the user. */
    var genre = GetGenre.value;

    /* Create the playlist using getByGenre. */
    var pl = Player.mediaCollection.getByGenre(genre);

    /* Make the new playlist the current playlist. */
    Player.currentPlaylist = pl;

    /* Play the digital media item in the new playlist. */
    Player.controls.play();
">

Requisitos

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

Consulte también

Objeto MediaCollection

Playlist (objeto)

Settings.mediaAccessRights

Settings.requestMediaAccessRights