MICROSOFT_PRESS_EBOOK_PROGRAMMING_WINDOWS_8_APPS_WITH_HTML_CSS_AND_JAVASCRIPT_PDF

function activated(eventObject) {
if (eventObject.detail.kind ===
Windows.ApplicationModel.Activation.ActivationKind.launch) {
if (eventObject.detail.arguments !== "") {
// Activation arguments are present (declared when the
// secondary tile was pinned)
eventObject.setPromise(WinJS.UI.processAll().done(function () {
// Navigate to Scenario 5, where the user will be shown
// the activation arguments
return WinJS.Navigation.navigate(scenarios[4].url,
eventObject.detail.arguments);
}));
} else {
// Activate in default state
}
}
}
The page control (js/LaunchedFromSecondaryTile.js) receives the arguments string in the options
parameter of both the processed and ready methods. In the case of the sample it just copies that string
to the display:
var page = WinJS.UI.Pages.define("/html/LaunchedFromSecondaryTile.html", {
processed: function (element, options) {
if (options) {
document.getElementById("launchedFromSecondaryTileOutput").innerHTML += "" +
"App was activated from a secondary tile with the following activation" +
"arguments : " + options + "";
}
},
ready: function (element, options) {
}
});
Your own app, of course, will do something much more interesting with arguments!
Managing Secondary Tiles
In addition to the methods and properties to create secondary tiles, the SecondaryTile class has two
static methods to generally manage your app’s secondary tiles:
• exists Returns a Boolean indicating whether a secondary tile, identified with its tileId, is
present on the Start screen. This tells you whether calling a requestCreate* method for a tile
with that same tileId will replace an existing one. This is demonstrated in Scenario 4 of the
Secondary tiles sample.
• findAllAsync Retrieves a vector of SecondaryTile objects that have been created by the app.
This will include any tiles roamed from another device (those created with the copyOnDeployment
575