エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

StorageFileQueryResult.FindStartIndexAsync | findStartIndexAsync Method

指定したプロパティ値 (または FileActivatedEventArgs.NeighboringFilesQuery と共に使用する場合は、指定したファイル) に最も近いクエリ結果から、ファイルのインデックスを取得します。一致するプロパティは、QueryOptions.SortOrder リストの最初の SortEntry によって決定されます。

構文


storageFileQueryResult.findStartIndexAsync(value).done( /* 成功ハンドラーとエラー ハンドラー */ );

パラメーター

value

型: Object [JavaScript] | System.Object [.NET] | Platform::Object [C++]

クエリ結果を検索するとき一致するプロパティ値。この値に一致させるために使用されるプロパティは、QueryOptions.SortOrder 一覧の最初の SortEntry にあるプロパティです。

または、FileActivatedEventArgs.NeighboringFilesQuery で検索するときに一致させるファイル。

戻り値

型: IAsyncOperation<UInt32>

このメソッドが正常に完了すると、一致するファイルのインデックスをクエリ結果に返すか、ファイルのインデックスを FileActivatedEventArgs.NeighboringFilesQuery に返します。後者の場合、ファイルは FileActivatedEventArgs.Files から提供されると想定されます。

解説

このメソッドを FileActivatedEventArgs.NeighboringFilesQuery と共に使用して、元のビューの並べ替え順序を維持しながら、隣接ファイル間で反復処理を実行することができます。

このインデックスをセマンティック ズームと組み合わせて使用すると、ユーザーがセマンティック ズーム コントロールを選択したときにページを拡大する場所を指定できます。JavaScript の SemanticZoom の詳細については、「Quickstart: adding SemanticZoom controls (クイック スタート: SemanticZoom コントロールの追加)」を参照してください。C#/C++/VB の SemanticZoom の詳細については、「Quickstart: adding SemanticZoom controls (クイック スタート: SemanticZoom コントロールの追加)」を参照してください。

Windows Phone 8

この API は実装されていません。呼び出された場合は、例外をスローします。「Windows Phone ランタイム API」を参照してください。

この例では、アルバム タイトルでグループ化された歌のある一連のクエリ結果で "R" で始まるタイトルを持つアルバムの最初の歌を検索する方法を示します。


var queryOptions = new Windows.Storage.Search.QueryOptions();
queryOptions.folderDepth = Windows.Storage.Search.FolderDepth.deep;
queryOptions.indexerOption = Windows.Storage.Search.IndexerOptions.onlyUseIndexer;
queryOptions.sortOrder.append({
	ascendingOrder: true,
	propertyName: "System.Music.AlbumTitle"
});

var queryResult = Windows.Storage.KnownFolders.picturesLibrary.createFileQueryWithOptions(queryOptions);
var firstIndex = queryResult.findStartIndexAsync("R");

要件

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

Windows 8

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

Windows Server 2012

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

Windows Phone 8 [実装されていません。"解説" を参照してください]

名前空間

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

メタデータ

Windows.winmd

参照

StorageFileQueryResult

 

 

表示:
© 2015 Microsoft