信息
您所需的主题如下所示。但此主题未包含在此库中。

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,请参见快速入门:添加 SemanticZoom 控件。若要了解在 C#/C++/VB 的 SemanticZoom,请参见快速入门:添加 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

 

 

显示: