IWMPMediaCollection::getByGenre-Methode
Die getByGenre -Methode gibt eine IWMPPlaylist-Schnittstelle zurück, die Zugriff auf Medienelemente des angegebenen Genre bereitstellt.
Syntax
public IWMPPlaylist getByGenre(
System.String bstrGenre
);
Public Function getByGenre( _
ByVal bstrGenre As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByGenre
Parameter
-
bstrGenre [ In]
-
Die System.String, die der Name des Genre ist.
Rückgabewert
Eine WMPLib.IWMPPlaylist-Schnittstelle für die abgerufenen Medienelemente.
Bemerkungen
Vor dem Aufrufen dieser Methode benötigen Sie Lesezugriff auf die Bibliothek. Weitere Informationen finden Sie unter Bibliothekszugriff.
Es gibt zwei Möglichkeiten, wie Sie eine IWMPMediaCollection-Schnittstelle abrufen können, und das Verhalten der getByGenre Methode hängt davon ab, welche dieser beiden Methoden Sie verwenden. Wenn Sie die Schnittstelle durch Aufrufen von AxWindowsMediaPlayer.mediaCollectionabrufen, gibt die getByGenre Methode alle Medienelemente in der Bibliothek zurück. Wenn Sie jedoch die Schnittstelle durch Aufrufen von IWMPLibrary.mediaCollectionabrufen, gibt die getByGenre Methode nur die Audioelemente in der Bibliothek zurück, die über das angegebene Attribut und den angegebenen Wert verfügen.
Beispiele
Im folgenden Beispiel wird getByGenre verwendet, um eine Wiedergabeliste von Medienelementen abzurufen, wenn der Benutzer auf eine Schaltfläche klickt. Die Wiedergabeliste enthält Elemente mit dem Genre, das vom Benutzer in einem Textfeld angegeben wird. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable player dargestellt.
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
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Version |
Windows Media Player 9er Serie oder höher |
| Namespace |
WMPLib |
| Assembly |
|