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 架構
• 徽章概觀