Méthode MediaCollection.getStringCollectionByQuery

[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 getStringCollectionByQuery récupère un objet StringCollection contenant toutes les chaînes qui correspondent aux conditions de requête.

Syntaxe

retVal = MediaCollection.getStringCollectionByQuery(
  attribute,
  query,
  mediaType,
  sortAttribute,
  sortAscending
)

Paramètres

attribute [in]

Chaîne contenant le nom de l’attribut.

requête [in]

Objet de requête .

mediaType [in]

Chaîne contenant le type de média. Doit contenir l’une des valeurs suivantes : « audio », « vidéo », « photo », « playlist » ou « autre ».

sortAttribute [in]

Chaîne contenant le nom d’attribut utilisé pour le tri. Une chaîne vide («  ») signifie qu’aucun tri n’est appliqué.

sortAscending [in]

Boolean, true indiquant que stringCollection doit être trié dans l’ordre croissant.

Valeur retournée

Cette méthode renvoie un objet StringCollection .

Notes

Les requêtes composées utilisant query ne respectent pas la casse.

Lorsque la requête composée spécifiée par le paramètre de requête contient une condition générée sur l’attribut MediaType , cette condition est ignorée. La valeur du paramètre mediaType est toujours utilisée. Par exemple, si la requête composée contient la condition « MediaType equals audio » et que la valeur du paramètre mediaType est « video », la playlist résultante contient uniquement des éléments vidéo.

Configuration requise

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

Voir aussi

Objet MediaCollection

Attribut MediaType

Objet Query