MediaCollection.getPlaylistByQuery メソッド

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

getPlaylistByQuery メソッドは、クエリ条件に一致する Media オブジェクトを含む Playlist オブジェクトを取得します。

構文

retVal = MediaCollection.getPlaylistByQuery(
  query,
  mediaType,
  sortAttribute,
  sortAscending
)

パラメーター

query [in]

プレイリストの作成に使用される条件を定義する Query オブジェクト。

mediaType [in]

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

sortAttribute [in]

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

sortAscending [in]

ブール値。プレイリストを昇順で並べ替える必要があることを示す true。

戻り値

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

解説

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

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

必要条件

要件	値
Version	Windows メディア プレーヤー 11.
[DLL]	Wmp.dll

関連項目

MediaCollection オブジェクト

MediaType 属性

Query オブジェクト