Metodo IWMPMediaCollection::getByGenre

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il getByGenre metodo restituisce un'interfaccia IWMPPlaylist che fornisce l'accesso agli elementi multimediali del genere specificato.

Sintassi

public IWMPPlaylist getByGenre(
  System.String bstrGenre
);

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

Parametri

bstrGenre [in]

System.String che corrisponde al nome del genere.

Valore restituito

Interfaccia WMPLib.IWMPPlaylist per gli elementi multimediali recuperati.

Commenti

Prima di chiamare questo metodo, è necessario disporre dell'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esistono due modi per recuperare un'interfaccia IWMPMediaCollection e il comportamento del getByGenre metodo dipende da quali di questi due modi usi. Se si recupera l'interfaccia chiamando AxWindowsMediaPlayer.mediaCollection, il getByGenre metodo restituisce tutti gli elementi multimediali nella raccolta. Tuttavia, se si recupera l'interfaccia chiamando IWMPLibrary.mediaCollection, il getByGenre metodo restituisce solo gli elementi audio nella libreria con l'attributo e il valore specificati.

Esempio

L'esempio seguente usa getByGenre per recuperare una playlist di elementi multimediali quando l'utente fa clic su un pulsante. La playlist contiene elementi con il genere specificato dall'utente in una casella di testo. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

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

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows serie 9 o successive
Spazio dei nomi	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

Interfaccia IWMPMediaCollection (VB e C#)

Interfaccia IWMPPlaylist (VB e C#)