TileUpdateManager.CreateTileUpdaterForSecondaryTile(String) Method
Definition
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.
Creates and initializes a new instance of the TileUpdater, which enables you to change the appearance of a secondary tile. The tile can belong to the calling app or any other app in the same package.
public:
static TileUpdater ^ CreateTileUpdaterForSecondaryTile(Platform::String ^ tileId);
static TileUpdater CreateTileUpdaterForSecondaryTile(winrt::hstring const& tileId);
public static TileUpdater CreateTileUpdaterForSecondaryTile(string tileId);
function createTileUpdaterForSecondaryTile(tileId)
Public Shared Function CreateTileUpdaterForSecondaryTile (tileId As String) As TileUpdater
Parameters
- tileId
-
String
Platform::String
winrt::hstring
A unique ID for the tile.
Returns
The object you will use to send updates to the tile identified by tileID.
Examples
The following example demonstrates how to send a notification to a secondary tile.
var Notifications = Windows.UI.Notifications;
// Define the notification content.
var tileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileWide310x150Text04);
var tileTextAttributes = tileXml.getElementsByTagName("text");
tileTextAttributes[0].appendChild(tileXml.createTextNode("Sent to a secondary tile!"));
// Provide a medium version of the notification as well, remembering that the user has control
// over whether the tile is displaying as wide or square.
var squareTileXml = Notifications.TileUpdateManager.getTemplateContent(Notifications.TileTemplateType.tileSquare150x150Text04);
var squareTileTextAttributes = squareTileXml.getElementsByTagName("text");
squareTileTextAttributes[0].appendChild(squareTileXml.createTextNode("Sent to a secondary tile!"));
// Add the medium tile to the notification.
var node = tileXml.importNode(squareTileXml.getElementsByTagName("binding").item(0), true);
tileXml.getElementsByTagName("visual").item(0).appendChild(node);
// Create the notification based on the XML content.
var tileNotification = new Notifications.TileNotification(tileXml);
// Create a secondary tile updater and pass it the secondary tileId
var tileUpdater = Notifications.TileUpdateManager.createTileUpdaterForSecondaryTile("SecondaryTile.Dynamic");
// Send the notification to the secondary tile.
tileUpdater.update(tileNotification);