Objet Media

  • Article

[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.]

L’objet Media permet de spécifier ou de récupérer les propriétés d’un élément multimédia à l’aide des propriétés et méthodes suivantes.

L’objet Media prend en charge les propriétés suivantes.

Propriété Description
attributeCount Récupère le nombre d’attributs pouvant être interrogés et/ou définis pour l’élément multimédia.
duration Récupère la durée en secondes de l’élément multimédia actuel.
durationString Récupère une valeur string indiquant la durée de l’élément multimédia actuel au format HH:MM:SS.
error Récupère un objet ErrorItem si l’élément multimédia a une condition d’erreur.
imageSourceHeight Récupère la hauteur de l’élément multimédia actuel en pixels.
imageSourceWidth Récupère la largeur de l’élément multimédia actuel en pixels.
markerCount Récupère le nombre de marqueurs dans l’élément multimédia.
name Spécifie ou récupère le nom de l’élément multimédia.
sourceURL Récupère l’URL de l’élément multimédia.

 

L’objet Media prend en charge les méthodes suivantes.

Méthode Description
getAttributeCountByType Récupère le nombre d’attributs associés au nom d’attribut et à la langue spécifiés.
getAttributeName Récupère le nom de l’attribut correspondant à l’index spécifié.
getItemInfo Récupère la valeur de l’attribut spécifié pour l’élément multimédia.
getItemInfoByAtom Récupère la valeur de l’attribut avec le numéro d’index spécifié.
getItemInfoByType Récupère la valeur de l’attribut correspondant au nom d’attribut, à la langue et à l’index spécifiés.
getMarkerName Récupère le nom du marqueur à l’index spécifié.
getMarkerTime Récupère l’heure du marqueur à l’index spécifié.
isIdentical Récupère une valeur indiquant si l’objet fourni est identique à l’objet actuel.
isMemberOf Récupère une valeur indiquant si l’élément multimédia spécifié est membre de la playlist spécifiée.
isReadOnlyItem Récupère une valeur indiquant si les attributs de l’élément multimédia spécifié peuvent être modifiés.
setItemInfo Définit la valeur de l’attribut spécifié pour l’élément multimédia.

 

L’objet Media est accessible via les propriétés et méthodes suivantes.

Object Propriété ou méthode
Contrôles Currentitem
Lecteur currentMedia, newMedia
Sélection item

 

Parce qu’il s’agit du moyen d’accès le plus courant, lecteur. currentMedia est utilisé à des fins d’illustration dans les sections de syntaxe de référence.

Voir aussi

Référence du modèle objet pour l’écriture de scripts