原文:快速构建Windows 8风格应用13-SearchContract构建

本篇博文主要介绍如何在应用中构建SearchContract,相应的原理已经在博文《快速构建Windows 8风格应用12-SearchContract概述及原理》中阐述清楚。

如何在应用中构建SearchContract

这里以常见的构建Search Contract功能为例,具体如下:

设置应用Search权限:

我们在应用中构建SearchContract之前,需要确认应用程序具有相应的Search能力,可以在应用清单文件中查看设置。

添加标准Search Contract页面:

应用的解决方案中添加Search Contract页面。

查看Search Contract页面默认生成的控件模版:

添加SearchResultPage.xaml页面后,自动会构建出用于页面显示搜索信息的控件模版。例如:

相应XAML设计器显示样式:

Search Contract页面对应cs文件LoadState方法中添加进行搜索数据代码:

SearchResultPage.xaml.cs文件的LoadState方法中根据搜索文本在应用数据中进行搜索,并添加到数据集合中。代码可如下所示:

更改Search Contract页面需要绑定的数据模版:

更改解决方案中Common文件夹下StandardStyles.xaml文件的StandardSmallIcon300x70ItemTemplate数据模版,设置该数据模版中我们要显示的字段控件。例如:

运行应用查看搜索效果:

 

到这里我们就可以利用Search Contract进行搜索信息了,并在添加的Search Contract页面显示搜索出来的结果。效果如图:

以上演示的是在应用程序运行的状态时进行搜索,其实应用程序在关闭状态下可以通过Search Contract启动并进行搜索。

应用程序外部启动:

App.xaml.cs文件中,需要重写OnSearchActivated方法来接收系统发送的搜索激活事件。OnSearchActivated方法在两种情况下进行触发:Search Contract面板中点击Search按钮和点击列表中某一应用时。

OnSearchActivated方法中编写应用程序在外部启动时进行搜索的代码。代码如下:

代码中首先判断当前应用程序状态是否为“NotRunning”、“ClosedByUser”、“Terminated”,若为这三种状态之一,先加载数据、注册SuggestionRequested(搜索建议)事件、最后激活SearchResultPage页面。

注意:可以通过设置SearchPane类GetForCurrentView()方法的PlaceholderText属性值,实现在Search Contract面板输入框中自定义提示文字,可以告诉用户可以输入什么进行搜索,当输入文字后提示文字就会自动消失。代码可如下;

实现效果:

异步搜索建议:

上篇博文提到为了提高用户体验,开发者应该必须在用户输入搜索信息时提供搜索建议。那么在应用中如何实现搜索建议呢?

注册Search Contract面板的搜索建议事件:

OnSuggestionsRequested方法中进行匹配相关的搜索建议。

代码中AppendQuerySuggestion()方法实现提供搜索建议。

注意:通过AppendQuerySuggestion()可以将一个数组信息全部添加到搜索建议中,但是目前搜索面板中最多显示5条搜索建议,这一点需要开发者在开发过程中注意到。

实现效果如图:

我们也可以通过AppendSearchSeparator()方法实现在搜索建议中提供必要的分栏。代码如下:

实现效果:

另外Search Contract中还提供了一种搜索推荐的形式,通过这个搜索推荐方便用户直接跳转到相应信息的详细页面。

实现搜索推荐需要借助SearchSuggestionCollection类的AppendResultSuggestion(string text, string detailText, string tag, IRandomAccessStreamReference image, string imageAlternateText)方法来实现。代码可如下:

代码中AppendResultSuggestion()方法中参数分别为:

  1. text和detaiText分别是搜索建议要显示的信息;
  2. tag是唯一标记,是用户点击ResultSuggestion而触发ReslutionSuggestionChosen事件时,程序收到的信息,从而页面可以显示出相应的结果;
  3. image是搜索推荐要显示的图像;
  4. imageAlternateText是image的附加信息,不显示在搜索面板中;

实现效果:

AppendQuerySuggestion()方法和AppendResultSuggestion()方法主要区别:

  1. AppendQuerySuggestion主要告诉用户搜索信息的建议,AppendResultSuggestion主要告诉用户可能搜索出来的结果;
  2. AppendQuerySuggestion中只包含文本信息,AppendResultSuggestion中包含image、title、detailtitle等信息;
  3. AppendResultSuggestion可以让用户直接导航到某一条信息的详细页面;

本地搜索建议

设置SearchPaneLocalContentSuggestionSettings,并取消OnSuggestionsRequested事件监听,可以提供本地文件的搜索建议。其中LocalContentSuggestionSettings类包含了搜索范围,路径和文件格式。代码可如下:

LocalContentSuggestionSettings类方法和属性可参考MSDN:LocalContentSuggestionSettings class

注意:要搜索到本地文件,需要在清单文件中开启对数据的读取权限。例如:

设置搜索历史:

长期使用我们应用之后会造成系统历史记录会变得非常冗长,可以通过以下代码关闭历史记录:

同时关于搜索历史还有一个属性:SearchHistoryContext

首先我们需要知道一个应用中可以包含多套搜索历史记录,通过SearchHistoryContext属性可以确实使用哪一套历史记录。

快速构建Windows 8风格应用13-SearchContract构建的更多相关文章

  1. 快速构建Windows 8风格应用24-App Bar构建

    原文:快速构建Windows 8风格应用24-App Bar构建 本篇博文主要介绍构建AppBar基本步骤.如何构建AppBar.如何在AppBar中构建上下文命令.如何在AppBar中构建菜单.如何 ...

  2. 快速构建Windows 8风格应用1-开发工具安装及模拟器使用

    原文:快速构建Windows 8风格应用1-开发工具安装及模拟器使用 本篇博文主要介绍的是开发Windows 8风格应用中常用的两个开发工具:Visual Studio 2012和Expression ...

  3. 快速构建Windows 8风格应用36-商店应用发布流程

    原文:快速构建Windows 8风格应用36-商店应用发布流程 引言 在发布应用之前,我们需要注册开发者账号才能够发布应用.我们可以登录https://appdev.microsoft.com/Sto ...

  4. 快速构建Windows 8风格应用31-构建磁贴

    原文:快速构建Windows 8风格应用31-构建磁贴 引言 磁贴是吸引用户经常使用应用重要手段之一.我们可将应用程序内较好的内容使用磁贴进行展示. 另外应用程序磁贴是应用程序中的核心部分,而且很可能 ...

  5. 快速构建Windows 8风格应用32-构建辅助磁贴

    原文:快速构建Windows 8风格应用32-构建辅助磁贴 引言 Windows Phone中,我们开发者可能会开发的一个功能点是将数据列表中某一项"Pin To Start(固定到开始屏幕 ...

  6. 快速构建Windows 8风格应用29-捕获图片与视频

    原文:快速构建Windows 8风格应用29-捕获图片与视频 引言 本篇博文主要介绍Windows 8中相机的概念.捕获图片与视频的基本原理.如何实现捕获图片与视频.相机最佳实践. 一.相机 关于相机 ...

  7. 快速构建Windows 8风格应用17-布局控件

    原文:快速构建Windows 8风格应用17-布局控件 本篇博文主要介绍三种常用的布局控件:Canvas.Grid.StackPanel. Panel类是开发Windows 8 Store应用中一个重 ...

  8. 快速构建Windows 8风格应用15-ShareContract构建

    原文:快速构建Windows 8风格应用15-ShareContract构建 本篇博文主要介绍共享数据包.如何构建共享源.如何构建共享目标.DataTransferManager类. 共享数据包 Da ...

  9. 快速构建Windows 8风格应用14-ShareContract概述及原理

    原文:快速构建Windows 8风格应用14-ShareContract概述及原理 本篇博文主要介绍Share Contract概述.Share Contract实现原理.实现Share Contra ...

随机推荐

  1. API访问客户端

    API访问客户端(WebApiClient适用于MVC/WebForms/WinForm) 这几天没更新主要是因为没有一款合适的后端框架来支持我们的Web API项目Demo, 所以耽误了几天, 目前 ...

  2. Cookie和Session (转)

    Session和Cookie在网站开发中是用来保存用户与后端服务器的交互状态.它们有各自的缺点和优点.而且,他们的优点和应用场景是对立的.   Cookie 完整地描述:当一个用户通过HTTP访问一个 ...

  3. 跟着辛星认识一下PHP的自己主动载入

    作为一个框架,文件的载入机制是不能少的,那么我们应该怎么载入呢,这些PHP已经给我们想好了,所以我们仅仅须要依照规则办事就能够了,PHP中有两个函数能够完毕这个功能,第一个是__autoload,如今 ...

  4. 解决LINUX vncserver 启动 could not open default font 'fixed'错.

    安装vncserver例如,会发生以下错误:  vncext:      VNC extension running!  vncext:      Listening for VNC connecti ...

  5. mysql数据库的安装以及常见优化设置

    原文请详见:http://www.ucai.cn/blogdetail/7036?mid=1&f=5 能够在线执行查看效果哦! 本文依据优才网课程整理,面向web开发人员,内容以有用为主,专业 ...

  6. JS列

    watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvU2h1aVRpYW5OYWlMdW8=/font/5a6L5L2T/fontsize/400/fill/I0 ...

  7. 构造activeMQ

    一.添加下列库 而配置的路径 ws2_32.lib;Mswsock.lib;cppunit.lib;libapr-1.lib;libapriconv-1.lib;libaprutil-1.lib;li ...

  8. 编程算法 - 数丑陋 代码(C)

    数丑陋 代码(C) 本文地址: http://blog.csdn.net/caroline_wendy 题目: 我们把仅仅包括因子2, 3 和 5的数称作丑数. 求按从小到大的顺序的第5个丑数. 能够 ...

  9. git stash用法

    使用场景: 当前修改的代码还不足以提交commit,但又必须切换到其他分支,要想完成这样的操作就可以使用git stash git stash意思就是备份当前的工作区的内容,从最近的一次提交中读取相关 ...

  10. Git与TortoiseGit基本操作(转)

    1. GitHub操作 本节先简单介绍 git 的使用与操作, 然后再介绍 TortoiseGit 的使用与操作. 先看看SVN的操作吧, 最常见的是 检出(Check out ...), 更新 (U ...