Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

SecondaryTile.RequestDeleteAsync() | requestDeleteAsync() method

Applies to Windows and Windows Phone

Displays the Unpin from Start flyout. This flyout lets the user confirm removal of the secondary 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. If tileId is not set, the call to this method raises an exception.

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

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.UI.StartScreen
Windows::UI::StartScreen [C++]

Metadata

Windows.winmd

See also

SecondaryTile
RequestDeleteAsync(Point)
Secondary tiles sample

 

 

Show:
© 2014 Microsoft