语言: HTML | XAML

快速入门:发送锁屏提醒更新 (XAML)

注意  不使用 C#/VB/C++?请参阅快速入门:发送锁屏提醒更新 (HTML)

本主题介绍如何在磁贴上创建或更新锁屏提醒。你将发送一个包含字形或数字值的锁屏提醒通知。还会介绍如何从磁贴中删除锁屏提醒。

锁屏提醒是显示在磁贴上以通过某种方式指示应用状态的一个数字或字形。锁屏提醒是磁贴上的重叠,而不是磁贴本身的一部分。它可以出现在磁贴上的多个位置中:

  • 在 Windows 右下角中,使用从左到右的语言(如英语)
  • 在 Windows 左下角中,使用从右到左的语言(如阿拉伯语)
  • 在 Windows Phone 8.1 右上角中,使用从左到右的语言
  • 在 Windows Phone 8.1 左上角中,使用从右到左的语言

锁屏提醒通过它自己的 API 和架构操作,并且通过它自己的通知进行更新。本主题指导你完成定义锁屏提醒的内容、通过通知发送锁屏提醒以及不再需要时将该内容删除的过程。 这些操作使用本地通知演示,本地通知是要实现的最简单的通知。

注意  在本主题中,你将直接通过 XML 文档对象模型 (DOM) 操作通知内容。通过 NotificationsExtensions 库可获得一种可选方法,该库将 XML 内容作为对象属性(包括 Intellisense)提供。有关详细信息,请参阅快速入门:在代码中使用 NotificationsExtensions 库。要查看本主题中使用 NotificationsExtenstions 表示的代码,请参阅应用磁贴和锁屏提醒示例

先决条件

要理解本主题,你将需要:

说明

1. 添加命名空间声明

Windows.UI.Notifications 包含锁屏提醒 API。



using namespace Windows::UI::Notifications;
using namespace Windows::Data::Xml::Dom;

2. 选择是显示数字还是字形

锁屏提醒可以显示数字 0-99 或系统定义的状态字形集之一。你选择的锁屏提醒将取决于你的方案。例如,电子邮件程序可能显示未读邮件的数量,也可能在新邮件到达时显示“新邮件”字形。有关可用字形的详细信息,请参阅锁屏提醒概述。有关何时使用数字或字形的详细信息,请参阅磁贴和锁屏提醒指南和清单

注意  从 Windows Phone 8.1 开始,手机锁屏提醒仅支持“警报”和“注意”状态字形以及数字。向手机发送任何其他字形将清除锁屏提醒。

数字锁屏提醒和字形锁屏提醒是通过用于每个锁屏提醒的特定锁屏提醒模板定义的。你必须为你决定的锁屏提醒检索适当的模板。该示例检索用于数字锁屏提醒的模板。



XmlDocument^ badgeXml = BadgeUpdateManager::GetTemplateContent(BadgeTemplateType::BadgeNumber);

该示例检索用于字形锁屏提醒的模板。



XmlDocument^ badgeXml = BadgeUpdateManager::GetTemplateContent(BadgeTemplateType::BadgeGlyph);

3. 为锁屏提醒分配值。

该示例从模板中检索 badge 元素并为该元素分配数字值。



XmlElement^ badgeElement = dynamic_cast<XmlElement^>(badgeXml->SelectSingleNode("/badge"));
badgeElement->SetAttribute("value", "7");

该示例为锁屏提醒分配字形值。



XmlElement^ badgeElement = dynamic_cast<XmlElement^>(badgeXml->SelectSingleNode("/badge"));
badgeElement->SetAttribute("value", "newMessage");

4. 创建锁屏提醒通知并将其发送至锁屏提醒。

该示例将你定义的 XML 打包至通知中并将其发送至锁屏提醒。



BadgeNotification^ badge = ref new BadgeNotification(badgeXml);
BadgeUpdateManager::CreateBadgeUpdaterForApplication()->Update(badge);

5. 可选:当锁屏提醒不再有效时将其清除

如果通过锁屏提醒数字或字形传达的信息已过期或者不再有用,那么你应该删除该锁屏提醒。以下代码从调用应用的磁贴中删除当前锁屏提醒。你也可以在调用 Clear 方法的位置发送值“None”作为锁屏提醒更新。

注意  与磁贴不同,锁屏提醒可以通过云清除。


BadgeUpdateManager::CreateBadgeUpdaterForApplication()->Clear();

摘要和后续步骤

在本快速入门中,你定义了新内容并将该内容发送到应用磁贴上的锁屏提醒,然后当该锁屏提醒不再有效时将其删除。

本快速入门将锁屏提醒更新作为本地通知发送。你还可以探索其他通知传递方法:已计划、定期和推送。有关详细信息,请参阅传送通知

相关主题

锁屏提醒概述
锁屏提醒架构
如何为锁屏提醒设置定期通知
BadgeTemplateType
BadgeNotification

 

 

显示:
© 2015 Microsoft