Metode MediaCollection.getByGenre

[Fitur yang terkait dengan halaman ini, Pemutar Media Windows SDK, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih Pemutar Media Windows SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode getByGenre mengambil daftar putar item media dengan genre yang ditentukan.

Sintaks

retVal = MediaCollection.getByGenre(
  genre
)

Parameter

genre [in]

String yang berisi nama genre.

Menampilkan nilai

Metode ini mengembalikan objek Playlist .

Keterangan

Untuk menggunakan metode ini, diperlukan akses baca ke pustaka. Untuk informasi selengkapnya, lihat Akses Pustaka.

Contoh

Contoh JScript berikut menggunakan MediaCollection. getByGenre untuk mengambil daftar putar item media. Daftar putar berisi item dengan genre yang ditentukan oleh pengguna dalam elemen input TEKS HTML bernama GetGenre. Objek Pemutar dibuat dengan ID = "Pemutar".

<!-- Use an HTML BUTTON element to create the playlist and play 
the media items. -->
<INPUT TYPE = "BUTTON"  
       NAME = "PlayGenre"  
       ID = "PlayGenre"  
       VALUE = "Play Genre"

onClick = "
    /* Retrieve the genre text from the user. */
    var genre = GetGenre.value;

    /* Create the playlist using getByGenre. */
    var pl = Player.mediaCollection.getByGenre(genre);

    /* Make the new playlist the current playlist. */
    Player.currentPlaylist = pl;

    /* Play the digital media item in the new playlist. */
    Player.controls.play();
">

Persyaratan

Persyaratan Nilai
Versi
Pemutar Media Windows versi 7.0 atau yang lebih baru.
DLL
Wmp.dll

Lihat juga

Objek MediaCollection

Objek Daftar Putar

Settings.mediaAccessRights

Settings.requestMediaAccessRights