Méthode MediaCollection.getByName
[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La méthode getByName récupère une playlist des éléments multimédias portant le nom spécifié.
Syntaxe
retVal = MediaCollection.getByName(
name
)
Paramètres
-
name [in]
-
Chaîne contenant le nom.
Valeur retournée
Cette méthode retourne un objet Playlist .
Notes
Pour utiliser cette méthode, un accès en lecture à la bibliothèque est requis. Pour plus d’informations, consultez Accès à la bibliothèque.
Exemples
L’exemple JScript suivant utilise MediaCollection. getByName pour récupérer trois éléments de la bibliothèque. Chaque élément est ensuite ajouté à la playlist active. L’objet Player a été créé avec ID="Player ».
// In each case, use the name exactly as it appears in the library.
// Windows Media Player does not include file name extensions or file paths
// in the name. Internet URLs include the entire path, but not the
// file name extension.
// Get a playlist object that contains an Internet URL.
var One = Player.mediaCollection.getByName("https://www.proseware.com/Media/Laure");
// Get a playlist object that contains a file on a network server.
var Two = Player.mediaCollection.getByName("Jeanne");
// Get a playlist object that contains a file on a local drive.
var Three = Player.mediaCollection.getByName("house");
// Append each item to the current playlist. Since each playlist retrieved
// using getByName contains one digital media item, use Playlist.item with
// an index of zero to reference that item.
Player.currentPlaylist.appendItem(One.item(0));
Player.currentPlaylist.appendItem(Two.item(0));
Player.currentPlaylist.appendItem(Three.item(0));
Configuration requise
Condition requise | Valeur |
---|---|
Version |
Lecteur multimédia Windows version 7.0 ou ultérieure. |
DLL |
|
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour