Método MediaCollection.getStringCollectionByQuery

Artículo
06/21/2023

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método getStringCollectionByQuery recupera un objeto StringCollection que contiene todas las cadenas que coinciden con las condiciones de consulta.

Sintaxis

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

Parámetros

atributo [in]: Cadena que contiene el nombre del atributo.
query [in]: Objeto de consulta .
mediaType [in]: Cadena que contiene el tipo de medio. Debe contener uno de los siguientes valores: "audio", "video", "photo", "playlist" u "other".
sortAttribute [in]: Cadena que contiene el nombre de atributo usado para la ordenación. Una cadena vacía ("") significa que no se aplica ninguna ordenación.
sortAscending [in]: Boolean, true que indica que stringCollection debe ordenarse en orden ascendente.

Valor devuelto

Este método devuelve un objeto StringCollection .

Observaciones

Las consultas compuestas que usan Query no distinguen mayúsculas de minúsculas.

Cuando la consulta compuesta especificada por el parámetro de consulta contiene una condición basada en el atributo MediaType , esa condición se omite. El valor del parámetro mediaType siempre se usa. Por ejemplo, si la consulta compuesta contiene la condición "MediaType Equals audio" y el valor del parámetro mediaType es "video", la lista de reproducción resultante solo contendrá elementos de vídeo.

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows 11.
Archivo DLL	Wmp.dll

Consulte también

Objeto MediaCollection
Atributo MediaType
Query (objeto)

Share via