MICROSOFT_PRESS_EBOOK_PROGRAMMING_WINDOWS_8_APPS_WITH_HTML_CSS_AND_JAVASCRIPT_PDF

Populate the XmlDocument in toastXml (code omitted)
}
var toast = new Notifications.ToastNotification(toastXml);
notificationManager.createToastNotifier().show(toast);
The following code from Scenario 3 (js/scenario3.js) demonstrates creating a toast with XML strings
(toastImageAndText01). As with tiles, you can use ms-appx:///, ms-appdata:///local, or http:// URIs to
refer to images (in-package, app data, and remote images, respectively):
function displayWebImageToastWithStringManipulation(e) {
// toastTemplateName is set according to the button you click
var notificationManager = Notifications.ToastNotificationManager;
var toastXmlString;
if (templateName === "toastImageAndText01") {
toastXmlString = ""
+ ""
+ ""
+ "Body text that wraps over three lines"
+ ""
+ ""
+ ""
+ "";
} else {
// Other cases omitted
}
}
var toastDOM = new Windows.Data.Xml.Dom.XmlDocument();
toastDOM.loadXml(toastXmlString);
var toast = new Notifications.ToastNotification(toastDOM);
notificationManager.createToastNotifier().show(toast);
Butter and Jam: Options for Your Toast
Beyond the properties you can assign when creating a ToastNotification object (or a
ScheduledToastNotification), there are additional bits you can include within the XML, as described in
the Toast schema:
• The root toast element in the XML has optional launch and duration attributes. The launch
attribute can be assigned a string that will be passed to the app’s activated handler as
eventArgs.detail.arguments, exactly as happens with a secondary tile. (See “App Activation
From a Secondary Tile” earlier in this chapter.) The duration attribute can have values of short
(five seconds or the value from PC Settings > Ease of Access) or long (25 seconds or the value
from PC Settings > Easy of Access, whichever is longer; refer back to Figure 13-7).
• The visual and binding elements in the XML can have branding and addImageQuery attributes
that act exactly like their counterparts for tiles. Refer back to the “Branding” and “Using Local
and Web Images” sections under “Tiles, Secondary Tiles, and Badges.” The image element also
602