BadgeUpdater 类

定义

命名空间:

Windows.UI.Notifications

汇报更新程序绑定到的特定磁贴上的锁屏提醒覆盖。

public ref class BadgeUpdater sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdater final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeUpdater

Public NotInheritable Class BadgeUpdater

继承

Object Platform::Object IInspectable BadgeUpdater

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

以下示例演示如何使用 Update 将数字锁屏提醒更新发送到调用应用的磁贴。

function sendBadgeNotification() {
    var Notifications = Windows.UI.Notifications;
    var badgeXml;
    var badgeAttributes;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
    badgeAttributes = badgeXml.getElementsByTagName("badge");
    badgeAttributes[0].setAttribute("value", "7");

    // Create a badge notification from the XML content.
    var badgeNotification = new Notifications.BadgeNotification(badgeXml);

    // Send the badge notification to the app's tile.
    Notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);
}

注解

若要获取此对象的实例，请调用 BadgeUpdateManager.CreateBadgeUpdaterForApplication 或 BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile 方法。

创建时，BadgeUpdater 绑定到特定的应用或辅助磁贴，因此此类的方法仅影响对象实例绑定到的单个磁贴。

方法

Clear()	从更新程序绑定到的磁贴中删除锁屏提醒。
StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)	从更新程序绑定到的 Web 资源开始对锁屏提醒进行一系列计时更新。 汇报在指定时间开始。 请注意，定期更新中仅允许 (http/https) 的 Web 资源。
StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)	从更新程序绑定到的 Web 资源开始一系列计时更新锁屏提醒，立即开始。 请注意，定期更新中仅允许 (http/https) 的 Web 资源。
StopPeriodicUpdate()	取消更新程序绑定到的锁屏提醒的当前计时更新系列。
Update(BadgeNotification)	对锁屏提醒的字形或编号应用更改。

另请参阅

• 应用磁贴和锁屏提醒示例
• 磁贴和锁屏提醒指南和清单
• 如何清除锁屏提醒
• 如何在本地通知中发送字形或数字锁屏提醒
• 如何为锁屏提醒设置定期通知
• 如何通过推送通知更新锁屏提醒
• 锁屏提醒 XML 架构
• 锁屏提醒概述