BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(String) Method

Reference

Definition

Namespace:: Windows.UI.Notifications

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Creates and initializes a new instance of the BadgeUpdater, which enables you to change the appearance or content of a badge on a secondary tile. The tile can belong to the calling app or any other app in the same package.

public:
 static BadgeUpdater ^ CreateBadgeUpdaterForSecondaryTile(Platform::String ^ tileId);

 static BadgeUpdater CreateBadgeUpdaterForSecondaryTile(winrt::hstring const& tileId);

public static BadgeUpdater CreateBadgeUpdaterForSecondaryTile(string tileId);

function createBadgeUpdaterForSecondaryTile(tileId)

Public Shared Function CreateBadgeUpdaterForSecondaryTile (tileId As String) As BadgeUpdater

Parameters

tileId: String
Platform::String

winrt::hstring

The unique ID of the tile.

Returns

BadgeUpdater

The object you will use to send badge updates to the tile identified by tileID.

Examples

The following example demonstrates how to send a numeric badge notification to a secondary tile with an ID of "SecondaryTile.Dynamic".

var Notifications = Windows.UI.Notifications;

// Define the badge content
var badgeNotification = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeNotification.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "6");

// Create the notification based on the XML content.
var badge = new Notifications.BadgeNotification(badgeNotification);

// Create a secondary tile updater, passing it the ID of the tile.
Notifications.BadgeUpdateManager.createBadgeUpdaterForSecondaryTile("SecondaryTile.Dynamic");

// Send the notification to the secondary tile.
tileUpdater.update(tileNotification);

Applies to