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

简介: 原文:快速构建Windows 8风格应用13-SearchContract构建本篇博文主要介绍如何在应用中构建SearchContract,相应的原理已经在博文《快速构建Windows 8风格应用12-SearchContract概述及原理》中阐述清楚。
原文: 快速构建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属性可以确实使用哪一套历史记录。

目录
相关文章
|
13天前
|
弹性计算 开发框架 安全
基于云效 Windows 构建环境和 Nuget 制品仓库进行 .Net 应用开发
本文将基于云效 Flow 流水线 Windows 构建环境和云效 Packages Nuget 制品仓库手把手教你如何开发并部署一个 .NET 应用,从环境搭建到实战应用发布的详细教程,帮助你掌握 .NET 开发的核心技能。
|
1月前
|
安全 前端开发 Windows
Windows Electron 应用更新的原理是什么?揭秘 NsisUpdater
本文介绍了 Electron 应用在 Windows 中的更新原理,重点分析了 `NsisUpdater` 类的实现。该类利用 NSIS 脚本,通过初始化、检查更新、下载更新、验证签名和安装更新等步骤,确保应用的更新过程安全可靠。核心功能包括差异下载、签名验证和管理员权限处理,确保更新高效且安全。
41 4
Windows Electron 应用更新的原理是什么?揭秘 NsisUpdater
|
2月前
|
XML 缓存 前端开发
Electron-builder 是如何打包 Windows 应用的?
本文首发于微信公众号“前端徐徐”,作者徐徐深入解析了 electron-builder 在 Windows 平台上的打包流程。文章详细介绍了 `winPackager.ts`、`AppxTarget.ts`、`MsiTarget.ts` 和 `NsisTarget.ts` 等核心文件,涵盖了目标创建、图标处理、代码签名、资源编辑、应用签名、性能优化等内容,并分别讲解了 AppX/MSIX、MSI 和 NSIS 安装程序的生成过程。通过这些内容,读者可以更好地理解和使用 electron-builder 进行 Windows 应用的打包和发布。
186 0
|
2月前
|
数据可视化 程序员 C#
C#中windows应用窗体程序的输入输出方法实例
C#中windows应用窗体程序的输入输出方法实例
56 0
|
4月前
|
vr&ar C# 图形学
WPF与AR/VR的激情碰撞:解锁Windows Presentation Foundation应用新维度,探索增强现实与虚拟现实技术在现代UI设计中的无限可能与实战应用详解
【8月更文挑战第31天】增强现实(AR)与虚拟现实(VR)技术正迅速改变生活和工作方式,在游戏、教育及工业等领域展现出广泛应用前景。本文探讨如何在Windows Presentation Foundation(WPF)环境中实现AR/VR功能,通过具体示例代码展示整合过程。尽管WPF本身不直接支持AR/VR,但借助第三方库如Unity、Vuforia或OpenVR,可实现沉浸式体验。例如,通过Unity和Vuforia在WPF中创建AR应用,或利用OpenVR在WPF中集成VR功能,从而提升用户体验并拓展应用功能边界。
88 0
|
4月前
|
存储 开发者 C#
WPF与邮件发送:教你如何在Windows Presentation Foundation应用中无缝集成电子邮件功能——从界面设计到代码实现,全面解析邮件发送的每一个细节密武器!
【8月更文挑战第31天】本文探讨了如何在Windows Presentation Foundation(WPF)应用中集成电子邮件发送功能,详细介绍了从创建WPF项目到设计用户界面的全过程,并通过具体示例代码展示了如何使用`System.Net.Mail`命名空间中的`SmtpClient`和`MailMessage`类来实现邮件发送逻辑。文章还强调了安全性和错误处理的重要性,提供了实用的异常捕获代码片段,旨在帮助WPF开发者更好地掌握邮件发送技术,提升应用程序的功能性与用户体验。
76 0
|
Windows 搜索推荐 开发者
快速构建Windows 8风格应用12-SearchContract概述及原理
原文:快速构建Windows 8风格应用12-SearchContract概述及原理 本篇博文主要介绍Search Contract概述、Search Contract面板结构剖析、Search Contract实现原理、Search Contract最佳实践。
903 0
|
1月前
|
网络安全 Windows
Windows server 2012R2系统安装远程桌面服务后无法多用户同时登录是什么原因?
【11月更文挑战第15天】本文介绍了在Windows Server 2012 R2中遇到的多用户无法同时登录远程桌面的问题及其解决方法,包括许可模式限制、组策略配置问题、远程桌面服务配置错误以及网络和防火墙问题四个方面的原因分析及对应的解决方案。