情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

CommonFolderQuery Enumeration

クエリが簡易か詳細かを指定し、クエリ結果でファイルをフォルダーにグループ化するための並べ替え条件を指定します。詳細なクエリのクエリ結果には、照会されるフォルダーのすべてのサブフォルダー内にある全ファイルと、指定されたメタデータに基づくグループが含まれます。

構文


var value = Windows.Storage.Search.CommonFolderQuery.defaultQuery;

属性

[Version(0x06020000)]

メンバー

CommonFolderQuery列挙型 にはこれらのメンバーがあります。

メンバー説明
DefaultQuery | defaultQuery0

Windows エクスプローラーが提供するビューと同様の、クエリしたフォルダー内の浅いフォルダー ビュー。 このオプションは任意の場所で有効です。

GroupByYear | groupByYear100

各ファイルの System.ItemDate プロパティに基づいてファイルを年ごとに仮想フォルダーにグループ分けします。各フォルダーには、同じ年内の [System.ItemDate] の値を持つすべて (のみ) のファイルが含まれます。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByMonth | groupByMonth101

各ファイルの System.ItemDate プロパティに基づいてファイルを月ごとに仮想フォルダーにグループ分けします。 結果として得られる各フォルダーには、同じ年内の [System.ItemDate] の値を持つすべて (のみ) のファイルが含まれます。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByArtist | groupByArtist102

各ファイルの System.Music.Artist プロパティに基づいてファイルを仮想フォルダーにグループ分けします。結果として得られる各フォルダーには、[System.Music.Artist] の同一の値を持つすべて (のみ) のファイルが含まれます。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByAlbum | groupByAlbum103

各ファイルの System.Music.AlbumTitle プロパティに基づいてファイルを年ごとに仮想フォルダーにグループ分けします。結果として得られる各フォルダーには、[System.Music.AlbumTitle] の同一の値を持つすべて (のみ) のファイルが含まれます。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByAlbumArtist | groupByAlbumArtist104

各ファイルの System.Music.AlbumArtist プロパティに基づいてファイルを仮想フォルダーにグループ分けします。結果として得られる各フォルダーには、[System.Music.AlbumArtist] の同一の値を持つすべて (のみ) のファイルが含まれます。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByComposer | groupByComposer105

各ファイルの System.Music.Composer プロパティに基づいてファイルを仮想フォルダーにグループ分けします。結果として得られる各フォルダーは 1 人の作曲者を表し、[System.Music.Composer] ベクターがその作曲者であるすべてのファイルが含まれます。ファイルに複数の作成者が示される場合は、結果として得られる複数のフォルダーに表示されることがあります。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByGenre | groupByGenre106

各ファイルの System.Music.Genre プロパティに基づいてファイルを仮想フォルダーにグループ分けします。結果として得られる各フォルダーには、[System.Music.Genre] の同一の値を持つすべて (のみ) のファイルが含まれます。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByPublishedYear | groupByPublishedYear107

各ファイルの System.Media.Year プロパティに基づいてファイルを年ごとに仮想フォルダーにグループ分けします。結果として得られる各フォルダーには、同じ年内の [ystem.Media.Year] の値を持つすべて (のみ) のファイルが含まれます。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByRating | groupByRating108

各ファイルの System.Rating プロパティに基づいて、ファイルを評価ごと (星 1 つ、星 2 つなど) に仮想フォルダーにグループ分けします。結果として得られる各フォルダーには、[System.Rating] の同一の値を持つすべて (のみ) のファイルが含まれます。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByTag | groupByTag109

各ファイルの System.Keywords プロパティに基づいてファイルを仮想フォルダーにグループ分けします。結果として得られる各フォルダーは 1 つのタグを表し、[System.Keywords] ベクターがそのタグであるすべてのファイルが含まれます。ファイルの System.Keywords ベクターに複数のタグが示される場合は、結果として得られる複数のフォルダーに表示されることがあります。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByAuthor | groupByAuthor110

各ファイルの System.Author プロパティに基づいてファイルを仮想フォルダーにグループ分けします。結果として得られる各フォルダーは 1 人の作成者を表し、[System.Author] ベクターがその作成者であるすべてのファイルが含まれます。ファイルに複数の作成者が示される場合は、結果として得られる複数のフォルダーに表示されることがあります。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

GroupByType | groupByType111

各ファイルの System.ItemTypeText プロパティに基づいて種類ごと (Microsoft Word ドキュメント、テキスト ファイルなど) の仮想フォルダーにファイルをグループ化します。

このオプションは、照会中のフォルダーがライブラリまたは HomeGroup フォルダー内にある場合にのみ有効です。

解説

複数の値を持つプロパティ (System.Author など) に基づいてファイルを仮想フォルダーにグループ化する場合、各グループは一意な値を表すため、特定のファイルが複数のフォルダーに表示されることがあります。

この列挙体を使用して、QueryOptions を構築するか、これらのメソッドのいずれかを呼び出すことによって、StorageFolderQueryResult を作成します。

これらのメソッドは、クエリの DateStackOptionFolderDepthIndexerOptionSortOrder オプションを初期化するために列挙値を使用します。

結果として得られるフォルダーのコンテンツを列挙するため、StorageFolderQueryResult オブジェクトを使用できます。

この列挙体を使用して、次の例のように storageFolder の位置で評価してファイルをグループ化する方法を指定します。


var picturesLibrary = Windows.Storage.KnownFolders.picturesLibrary;
var storageFolderQueryResults = picturesLibrary.createFolderQuery(Windows.Storage.Search.CommonFolderQuery.groupByRating);

メモ  例では、画像ライブラリを使用しますが、ユーザーがアクセスできる場所と storageFolder オブジェクトによって表すことができる場所を使用できます。

要件

最小限サポートされるクライアント

Windows 8

最小限サポートされるサーバー

Windows Server 2012

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.Storage.Search
Windows::Storage::Search [C++]

メタデータ

Windows.winmd

参照

queryOptions class
Windows.Storage.storageFolder class

 

 

表示: