MICROSOFT_PRESS_EBOOK_PROGRAMMING_WINDOWS_8_APPS_WITH_HTML_CSS_AND_JAVASCRIPT_PDF

function pinSecondaryTile() {
var Scenario1TileId = "SecondaryTile.Logo";
var uriLogo = new Windows.Foundation.Uri(
"ms-appx:///images/SecondaryTileDefault-sdk.png");
var uriSmallLogo = new Windows.Foundation.Uri(
"ms-appx:///images/smallLogoSecondaryTile-sdk.png");
// Create activation arguments...
var currentTime = new Date();
var newTileActivationArguments = Scenario1TileId + " WasPinnedAt=" + currentTime;
var tile = new Windows.UI.StartScreen.SecondaryTile(Scenario1TileId,
"Title text shown on the tile",
"Name of the tile the user sees when searching for the tile",
newTileActivationArguments,
Windows.UI.StartScreen.TileOptions.showNameOnLogo, uriLogo);
// Setting other options
tile.foregroundText = Windows.UI.StartScreen.ForegroundText.dark;
tile.smallLogo = uriSmallLogo;
var selectionRect = document.getElementById("pinButton").getBoundingClientRect();
}
tile.requestCreateForSelectionAsync(
{ x: selectionRect.left, y: selectionRect.top, width: selectionRect.width,
height: selectionRect.height },
Windows.UI.Popups.Placement.below)
.done(function (isCreated) {
if (isCreated) {
// The tile was successfully created
} else {
// The tile was not created
}
});
Note As mentioned in Chapter 7, the system flyout displayed when creating a secondary tile (and when
removing it, see “Managing Secondary Tiles” below), will cause the app to lose focus and will dismiss a
nonsticky app bar as a result. For this reason, Scenario 7 of the Secondary tiles sample keeps the app
bar visible by setting its sticky property to true before calling the secondary tile API.
App Activation From a Secondary Tile
Secondary tiles provide a way to activate an app to something other than its default state, similar to
how command-line arguments work with desktop or console apps. This process depends entirely on the
contents of the secondary tile’s arguments property. When a secondary tile is tapped or clicked, the
app’s activated event is fired with an activation kind of launch and the tile’s arguments value in
eventArgs.detail.arguments. The app then takes whatever action is appropriate for that data, such as
navigating to a particular page of content, retrieving a piece of content from an online source, and so
on. In the Secondary tiles sample, the activation code in js/default.js navigates to its Scenario 5 page,
where we pass arguments as the options parameter of WinJS.Navigation.navigate:
574