Controls.playItem, méthode

[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 playItem lit l’élément multimédia spécifié.

Syntaxe

Controls.playItem(
  theMediaItem
)

Paramètres

theMediaItem [in]

Objet multimédia à lire.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

L’élément multimédia est chargé et lu automatiquement, quelle que soit la valeur des Paramètres. propriété autoStart . Pour charger un élément sans le lire automatiquement, définissez Paramètres. autoDémarrer sur false et affecter une valeur à Player. URL, après laquelle la lecture peut être appelée pour commencer à lire l’élément.

Notes

playItem fonctionne uniquement avec les éléments dans currentPlaylist. L’appel de playItem avec une référence à un élément multimédia enregistré n’est pas pris en charge.

Exemples

L’exemple JScript suivant utilise playItem pour lire un élément multimédia à partir de la playlist actuelle. L’élément à lire est choisi en fonction de sa position dans la playlist. L’objet Player a été créé avec ID = « Player ».

// Declare a variable to hold the position of the media item 
// in the current playlist. An arbitrary value is supplied here.
var index = 3

// Retrieve the media item at the fourth position in the current playlist.
var media = Player.currentPlaylist.item(index);

// Play the media item.
Player.controls.playItem(media);

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Controls, objet

Playlist.item