SecondaryTile.RequestDeleteAsync() | requestDeleteAsync() method

Displays a preview of the secondary tile with a confirmation dialog to delete the tile.

Syntax

secondaryTile.requestDeleteAsync().done( /* Your success and error handlers */ );

Parameters

This method has no parameters.

Return value

Type: IAsyncOperation<Boolean>

An object that provides information concerning the asynchronous delete operation.

Remarks

The only property that must be set on the tile before calling this method is tileId.

This method returns an asynchronous Boolean value through its IAsyncOperation object as shown here.

  
[JavaScript]  
secondaryTile.requestCreateAsync().then( function (isDeleted) { } );

Examples

The following example demonstrates how to delete (unpin) a secondary tile. Note that this example assumes that the tile exists. To determine whether the tile is pinned before you call RequestDeleteAsync, see the Exists method.

// Specify the tile to be deleted, using the ID that it was given when it was originally created.
var tileToBeDeleted = new Windows.UI.StartScreen.SecondaryTile("SecondaryTile.01");

// Make the delete request.
tileToBeDeleted.requestDeleteAsync().then(function (isDeleted) {
    if (isDeleted) {
        // Secondary tile successfully deleted.
    } else {
        // Secondary tile not deleted.
    }
});

Requirements

See also

SecondaryTile

RequestDeleteAsync(Point)

Secondary tiles sample

Build date: 12/4/2012