MediaCollection.getStringCollectionByQuery メソッド

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

getStringCollectionByQuery メソッドは、クエリ条件に一致するすべての文字列を含む StringCollection オブジェクトを取得します。

構文

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

パラメーター

属性 [in]

属性名を含む文字列。

query [in]

Query オブジェクト。

mediaType [in]

メディアの種類を含む文字列。 "audio"、"video"、"photo"、"playlist"、または "other" のいずれかの値を含む必要があります。

sortAttribute [in]

並べ替えに使用される属性名を含む文字列。 空の文字列 ("") は、並べ替えが適用されていないことを意味します。

sortAscending [in]

Boolean。 StringCollection を昇順で並べ替える必要があることを示す true。

戻り値

このメソッドは、 StringCollection オブジェクトを返します。

解説

クエリを使用した複合クエリでは、大文字と小文字は区別されません。

クエリ パラメーターで指定された複合 クエリ に MediaType 属性に基づいて構築された条件が含まれている場合、その条件は無視されます。 mediaType パラメーターの値は常に使用されます。 たとえば、複合クエリに "MediaType Equals audio" という条件が含まれており、 mediaType パラメーターの値が "video" の場合、結果の再生リストにはビデオ項目のみが含まれます。

必要条件

要件	値
バージョン	Windows メディア プレーヤー 11.
[DLL]	Wmp.dll

関連項目

MediaCollection オブジェクト

MediaType 属性

Query オブジェクト