Share via


Metodo MediaCollection.getStringCollectionByQuery

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getStringCollectionByQuery recupera un oggetto StringCollection contenente tutte le stringhe che soddisfano le condizioni di query.

Sintassi

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

Parametri

attributo [in]

Stringa contenente il nome dell'attributo.

query [in]

Oggetto Query .

mediaType [in]

Stringa contenente il tipo di supporto. Deve contenere uno dei valori seguenti: "audio", "video", "photo", "playlist" o "other".

sortAttribute [in]

Stringa contenente il nome dell'attributo usato per l'ordinamento. Una stringa vuota ("") indica che non viene applicato alcun ordinamento.

sortAscending [in]

Boolean, true che indica che StringCollection deve essere ordinato in ordine crescente.

Valore restituito

Questo metodo restituisce un oggetto StringCollection .

Commenti

Le query composte che usano Query non fanno distinzione tra maiuscole e minuscole .

Quando la query composta specificata dal parametro di query contiene una condizione basata sull'attributo MediaType , tale condizione viene ignorata. Il valore per il parametro mediaType viene sempre usato. Ad esempio, se la query composta contiene la condizione "MediaType Equals audio" e il valore per il parametro mediaType è "video", la playlist risultante conterrà solo elementi video.

Requisiti

Requisito Valore
Versione
Lettore multimediale Windows 11.
DLL
Wmp.dll

Vedi anche

Oggetto MediaCollection

Attributo MediaType

Oggetto Query