IWMPStringCollection2 :: getItemInfobyType, méthode

La méthode getItemInfoByType retourne la valeur correspondant à l’index de l’élément de collection de chaînes, au nom, à la langue et à l’index d’attributs spécifiés.

Syntaxe

public System.Object getItemInfobyType(
  System.Int32 lCollectionIndex,
  System.String bstrType,
  System.String bstrLanguage,
  System.Int32 lAttributeIndex
);

Public Function getItemInfobyType( _
  ByVal lCollectionIndex As System.Int32, _
  ByVal bstrType As System.String, _
  ByVal bstrLanguage As System.String, _
  ByVal lAttributeIndex As System.Int32 _
) As System.Object
Implements IWMPStringCollection2.getItemInfobyType

Paramètres

lCollectionIndex [ dans]

System. Int32 qui est l’index de base zéro de l’élément de collection de chaînes à partir duquel l’attribut doit être obtenu.

bstrType [ dans]

System. String qui est le nom de l’attribut.

bstrLanguage [ dans]

System. String qui indique la langue. Si la valeur est définie sur null ou sur une chaîne de longueur nulle (""), la chaîne de paramètres régionaux active est utilisée. Dans le cas contraire, la valeur doit être une chaîne valide du langage RFC 1766, par exemple « en-US ».

lAttributeIndex [ dans]

System. Int32 qui correspond à l’index de base zéro de l’attribut.

Valeur retournée

System. Object qui est l’élément de collection de chaînes.

Remarques

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

En passant la valeur « ChildList » dans le paramètre bstrType , vous pouvez récupérer une nouvelle collection de chaînes qui contient les enfants de l’un des éléments de la collection de chaînes parente. Par exemple, si la collection parente contient une liste de AlbumIDs, vous pouvez utiliser cette méthode pour obtenir une collection de chaînes enfant qui contient toutes les pistes de l’un des albums. Cette approche est plus rapide et plus efficace que l’appel de la méthode IWMPMediaCollection2. getStringCollectionByQuery à deux reprises. une fois pour obtenir une collection de AlbumIDs et une deuxième fois pour obtenir une collection de pistes pour un AlbumID particulier. Pour utiliser ChildList de la manière décrite ci-dessus, la collection de chaînes parent doit être obtenue à partir d’une collection de médias via IWMPLibraryServices, et non à l’aide de la propriété AxWindowsMediaPlayer. mediaCollection .

Lorsque vous utilisez ChildList, transmettez la valeur « ChildList » dans le paramètre bstrType et la valeur 0 dans le paramètre lAttributeIndex . Vous pouvez ensuite effectuer un cast de l’objet qui est retourné à une interface IWMPStringCollection2 pour accéder à la liste enfant.

Pour utiliser cette méthode, vous devez disposer d’un accès en lecture à la bibliothèque. Pour plus d’informations, consultez accès à la bibliothèque.

Configuration requise

Condition requise Valeur
Version
Lecteur Windows Media 11.
Espace de noms
WMPLib
Assembly
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

Attribut AlbumID

Interface IWMPLibraryServices (VB et C#)

IWMPMediaCollection2. getStringCollectionByQuery (VB et C#)

Interface IWMPStringCollection2

IWMPStringCollection2. getItemInfo (VB et C#)