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

StorageItemQueryResult.FindStartIndexAsync | findStartIndexAsync Method

指定したプロパティ値に最も近いクエリ結果から、項目のインデックスを取得します。一致するプロパティは、QueryOptions.SortOrder リストの最初の SortEntry によって決定されます。

構文


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

パラメーター

value

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

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

戻り値

型: IAsyncOperation<UInt32>

このメソッドが正常に完了すると、一致する項目のインデックスをクエリ結果に返します。

解説

このインデックスをセマンティック ズームと組み合わせて使用すると、ユーザーがセマンティック ズーム コントロールを選択したときにページを拡大する場所を指定できます。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.createFolderQueryWithOptions(queryOptions);
var firstIndex = queryResult.findStartIndexAsync("R");

要件

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

Windows 8

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

Windows Server 2012

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

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

名前空間

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

メタデータ

Windows.winmd

参照

StorageItemQueryResult

 

 

表示:
© 2015 Microsoft