BadgeUpdateManager 类

定义

命名空间:

Windows.UI.Notifications

创建用于操作磁贴锁屏提醒覆盖的 BadgeUpdater 对象。 此类还提供对系统提供的锁屏提醒模板的 XML 内容的访问权限，以便你可以自定义该内容以用于更新锁屏提醒。

public ref class BadgeUpdateManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdateManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class BadgeUpdateManager

Public Class BadgeUpdateManager

继承

Object Platform::Object IInspectable BadgeUpdateManager

属性

ContractVersionAttribute ThreadingAttribute 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 中引入)

示例

以下示例演示如何使用 GetTemplateContent 为数字锁屏提醒创建内容，使用 CreateBadgeUpdaterForApplication 将数字锁屏提醒更新发送到调用应用的磁贴。

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);
}

注解

版本历史记录

Windows 版本	SDK 版本	已添加值
1607	14393	GetForUser

方法

CreateBadgeUpdaterForApplication()	创建并初始化 BadgeUpdater 的新实例，使你可以在调用应用的磁贴上更改锁屏提醒的外观或内容。
CreateBadgeUpdaterForApplication(String)	为指定应用磁贴的锁屏提醒（通常是包中另一个应用的磁贴）创建并初始化 BadgeUpdater 的新实例。 BadgeUpdater 允许你更改该锁屏提醒的外观或内容。
CreateBadgeUpdaterForSecondaryTile(String)	创建并初始化 BadgeUpdater 的新实例，使你能够更改 辅助磁贴上锁屏提醒的外观或内容。 磁贴可以属于调用应用或同一包中的任何其他应用。
GetForUser(User)	为指定用户创建并初始化新的 BadgeUpdateManagerForUser ，使你能够更改特定用户磁贴上锁屏提醒的外观或内容。
GetTemplateContent(BadgeTemplateType)	获取其中一个预定义锁屏提醒模板的 XML 内容，以便可以自定义锁屏提醒更新。

另请参阅

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