Windows Media Player 11 SDK IWMPMediaCollection.getByGenre (VB and C#) 

Previous

Next

IWMPMediaCollection.getByGenre (VB and C#)

The getByGenre method returns an IWMPPlaylist interface that provides access to media items of the specified genre.

Parameters

bstrGenre

The System.String that is the name of the genre.

Return Value

A WMPLib.IWMPPlaylist interface for the retrieved media items.

Remarks

Before calling this method, you must have read access to the library. For more information, see Library Access.

There are two ways you ways you can retrieve an IWMPMediaCollection interface, and the behavior of the getByGenre method depends on which of those two ways you use. If you retrieve the interface by calling AxWindowsMediaPlayer.mediaCollection, then the getByGenre method returns all the media items in the library. However, if you retrieve the interface by calling IWMPLibrary.mediaCollection, then the getByGenre method returns only the audio items in the library that have the specified attribute and value.

Example Code

The following example uses getByGenre to retrieve a playlist of media items when the user clicks a button. The playlist contains items with the genre specified by the user in a text box. The AxWMPLib.AxWindowsMediaPlayer object is represented by the variable named player.

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

FakePre-4e77beb2316145e18d16219d5ad717f5-b9fd6335be1d4cda87d797b18d42b364

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();
}

Requirements

Version: Windows Media Player 9 Series or later

Namespace: WMPLib

Assembly: Interop.WMPLib.dll (automatically generated by Visual Studio)

See Also

• IWMPMediaCollection Interface (VB and C#)
• IWMPPlaylist Interface (VB and C#)

Previous

Next