MICROSOFT_PRESS_EBOOK_PROGRAMMING_WINDOWS_8_APPS_WITH_HTML_CSS_AND_JAVASCRIPT_PDF

The other bits of the manifest that affect a tile update are the Foreground Text and Background
Color settings in the Application UI section. These define how tile text appears for all tile updates (and
toasts for that matter), and they cannot be altered in the tile payload. This keeps the branding of the
app consistent between updates; users would certainly find it confusing if multiple tiles from the same
app showed up in different colors.
As a quick example, the SDK sample we’ve been working with here uses Light foreground text and a
background color of #00b2f0. If I go to Scenario 5, choose the TileWideText09 template, add some text,
and select Logo for the branding (where the small logo contains a block with “SDK” in it), the result is as
follows:
Cycling, Scheduled, and Expiring Updates
Although you might read the heading for this section and think it’s just going to be a grab bag of
randomness, all it really means is that we’re looking at additional methods of the TileUpdater object
and revisiting the two properties of the TileNotification object that we already mentioned. Simply
said, now that we’ve seen how to do all the basic tile updates we’re ready to start exploring the
additional capabilities. Again, everything here applies to all tiles in the app.
First is the ability to programmatically clear all updates and reset the tile to its default state as
defined in the manifest. This happens with a simple call to TileUpdater.clear (shown in Scenario 1):
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().clear();
The next capability, as already mentioned, is to set the TileNotification.expirationTime property
before sending that notification to TileUpdater.update. This ensures that a locally issued notification
will be automatically removed, and it lets you override the default three-day expiration period for
cloud-issued updates. The update will appear immediately (at the next tile refresh, that is) and will then
be removed from the tile after it expires. This is demonstrated in Scenario 7 of the sample—sending an
update with an expiration date will display an update as on the left below. When it expires, it’s removed,
which in this case causes the tile to revert to its default state, as shown on the right (and yeah, I’m
working on this book on a Sunday night!):
585