Metodo MediaCollection.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 metodo getByGenre recupera una playlist degli elementi multimediali con il genere specificato.

Sintassi

retVal = MediaCollection.getByGenre(
  genre
)

Parametri

genere [in]

Stringa contenente il nome del genere.

Valore restituito

Questo metodo restituisce un oggetto Playlist .

Commenti

Per usare questo metodo, è necessario l'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esempio

L'esempio JScript seguente usa MediaCollection. getByGenre per recuperare una playlist di elementi multimediali. La playlist contiene elementi con il genere specificato dall'utente in un elemento di input HTML TEXT denominato GetGenre. L'oggetto Player è stato creato con ID = "Player".

<!-- 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();
">

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Oggetto MediaCollection

Oggetto Playlist

Settings.mediaAccessRights

Settings.requestMediaAccessRights