Méthode MediaCollection.getByGenre

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode getByGenre récupère une playlist des éléments multimédias avec le genre spécifié.

Syntaxe

retVal = MediaCollection.getByGenre(
  genre
)

Paramètres

genre [in]

Chaîne contenant le nom du genre.

Valeur retournée

Cette méthode retourne un objet Playlist .

Notes

Pour utiliser cette méthode, un accès en lecture à la bibliothèque est requis. Pour plus d’informations, consultez Accès à la bibliothèque.

Exemples

L’exemple JScript suivant utilise MediaCollection. getByGenre pour récupérer une playlist d’éléments multimédias. La playlist contient des éléments avec le genre spécifié par l’utilisateur dans un élément d’entrée HTML TEXT nommé GetGenre. L’objet Player a été créé avec l’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();
">

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Objet MediaCollection

Playlist, objet

Settings.mediaAccessRights

Settings.requestMediaAccessRights