StringCollection.getItemInfoByType, 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 getItemInfoByType récupère la valeur correspondant à l’index StringCollection , au nom, à la langue et à l’index d’attribut spécifiés.

Syntaxe

retVal = StringCollection.getItemInfoByType(
  index,
  name,
  language,
  attributeIndex
)

Paramètres

index [in]

Nombre (long) spécifiant l’index de base zéro de l’élément StringCollection à partir duquel obtenir l’attribut.

name [in]

Chaîne contenant le nom de l’attribut.

language [in]

Chaîne contenant la langue. Si la valeur est définie sur null ou la chaîne vide («  »), la chaîne de paramètres régionaux actuelle est utilisée. Sinon, la valeur doit être une chaîne de langage RFC 1766 valide telle que « en-us ».

attributeIndex [in]

Nombre (long) contenant l’index de base zéro de la valeur à récupérer à partir de l’attribut .

Valeur retournée

Cette méthode renvoie un objet Number, String, MetadataPicture ou MetadataText , comme indiqué dans le tableau suivant.

Attribut	Valeur retournée
SyncState	Nombre (long non signé)
WM/Lyrics_Synchronised	Objet MetadataText
WM/Image	Objet MetadataPicture
WM/UserWebURL	Objet MetadataText
Tous les autres attributs	String

Pour les attributs dont la valeur sous-jacente est Boolean, cette méthode retourne la chaîne « true » ou « false ».

Notes

Cette méthode prend en charge les attributs avec plusieurs valeurs et les attributs avec des valeurs complexes. La méthode getItemInfo ne prend pas en charge les attributs avec des valeurs multiples ou complexes.

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.

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows 11.
DLL	Wmp.dll

Voir aussi

MetadataPicture, objet

MetadataText, objet

StringCollection.getItemInfo

StringCollection, objet