Méthode MediaCollection.getByAlbum
[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 GetByAlbum récupère une playlist contenant les éléments multimédias de l’album spécifié.
Syntaxe
retVal = MediaCollection.getByAlbum(
album
)
Paramètres
-
album [in]
-
Chaîne contenant le nom de l’album.
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 suivant utilise MediaCollection. getByAlbum pour récupérer une playlist d’éléments multimédias. La playlist contient des éléments avec l’album spécifié par l’utilisateur dans un élément d’entrée HTML TEXT nommé GetAlbum. L’objet Player a été créé avec l’ID = « Player ».
<!-- Use an HTML BUTTON element to create the playlist and
then play the digital media items. -->
<INPUT TYPE = "BUTTON"
NAME = "PlayAlbum"
ID = "PlayAlbum"
VALUE = "Play Album"
onClick = "
/* Retrieve the album title text from the user. */
var album = GetAlbum.value;
/* Create the playlist using getByAlbum. */
var pl = Player.mediaCollection.getByAlbum(album);
/* Make the new playlist the current playlist. */
Player.currentPlaylist = pl;
/* Play the media in the new playlist. */
Player.controls.play();
">
Configuration requise
Condition requise | Valeur |
---|---|
Version |
Lecteur multimédia Windows version 7.0 ou ultérieure. |
DLL |
|
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour