Méthode MediaCollection. getByAlbum

La méthode GetByAlbum récupère une sélection contenant les éléments multimédias de l’album spécifié.

Syntaxe

retVal = MediaCollection.getByAlbum(
  album
)

Paramètres

album [ dans]

Chaîne contenant le nom de l’album.

Valeur de retour

Cette méthode retourne un objet playlist .

Notes

Pour utiliser cette méthode, l’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 sélection d’éléments multimédias. La sélection contient des éléments avec l’album spécifié par l’utilisateur dans un élément d’entrée de texte HTML nommé GetAlbum. L’objet Player a été créé avec 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 Windows Media version 7,0 ou ultérieure.
DLL
Wmp.dll

Voir aussi

Objet MediaCollection

Objet playlist

Paramètres. mediaAccessRights

Paramètres. requestMediaAccessRights