IWMPMediaCollection::getByGenre, méthode

La getByGenre méthode retourne une interface IWMPPlaylist qui fournit l’accès aux éléments multimédias du genre spécifié.

Syntaxe

public IWMPPlaylist getByGenre(
  System.String bstrGenre
);

Public Function getByGenre( _
  ByVal bstrGenre As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByGenre

Paramètres

bstrGenre [in]

System.String qui est le nom du genre.

Valeur retournée

Interface WMPLib.IWMPPlaylist pour les éléments multimédias récupérés.

Notes

Avant d’appeler cette méthode, vous devez avoir accès en lecture à la bibliothèque. Pour plus d’informations, consultez Accès à la bibliothèque.

Il existe deux façons de récupérer une interface IWMPMediaCollection et le comportement de la getByGenre méthode dépend de ces deux façons d’utiliser. Si vous récupérez l’interface en appelant AxWindowsMediaPlayer.mediaCollection, la getByGenre méthode retourne tous les éléments multimédias de la bibliothèque. Toutefois, si vous récupérez l’interface en appelant IWMPLibrary.mediaCollection, la getByGenre méthode retourne uniquement les éléments audio de la bibliothèque qui ont l’attribut et la valeur spécifiés.

Exemples

L’exemple suivant utilise getByGenre pour récupérer une playlist d’éléments multimédias lorsque l’utilisateur clique sur un bouton. La playlist contient des éléments avec le genre spécifié par l’utilisateur dans une zone de texte. L’objet AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée lecteur.

private void playGenre_Click(object sender, System.EventArgs e)
{ 
    // ...Add code to ensure that the text box contains a valid value.
 
    // Retrieve the genre that the user entered in the text box. 
    string genre = getGenre.Text;

    // Create the playlist using getByGenre. 
    WMPLib.IWMPPlaylist pl = player.mediaCollection.getByGenre(genre);

    // Make the new playlist the current playlist. 
    player.currentPlaylist = pl;

    // Play the media in the current playlist. 
    player.Ctlcontrols.play();
}

Public Sub playGenre_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles playGenre.Click

    ' ...Add code to ensure that the text box contains a valid value.

    ' Retrieve the genre that the user entered in the text box. 
    Dim genre As String = getGenre.Text

    ' Create the playlist using getByGenre. 
    Dim pl As WMPLib.IWMPPlaylist = player.mediaCollection.getByGenre(genre)

    ' Make the new playlist the current playlist. 
    player.currentPlaylist = pl

    ' Play the media in the current playlist. 
    player.Ctlcontrols.play()

End Sub

Spécifications

Condition requise Valeur
Version
Lecteur multimédia Windows série 9 ou ultérieure
Espace de noms
WMPLib
Assembly
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

IWMPMediaCollection Interface (VB et C#)

IWMPPlaylist Interface (VB et C#)