SecondaryTile.FindAllForPackageAsync | findAllForPackageAsync method

Applies to Windows and Windows Phone

Retrieves a list of secondary tiles created for all of the apps in the package of the calling app.

When an app launches, it should always enumerate its secondary tiles through this method, in case there were any additions or deletions of which it was unaware. When a secondary tile is deleted through the Start screen app bar, Windows simply removes the tile. The app itself is responsible for releasing any resources that were used by the secondary tile. When secondary tiles are copied through the cloud, current tile or badge notifications on the secondary tile, scheduled notifications, push notification channels, and Uniform Resource Identifiers (URIs) used with periodic notifications are not copied with the secondary tile and must be reset up.

Syntax


Windows.UI.StartScreen.SecondaryTile.findAllForPackageAsync().done( /* Your success and error handlers */ );

Parameters

This method has no parameters.

Return value

Type: IAsyncOperation<IVectorView>

An enumeration object that allows you to examine the set of tiles.

Remarks

This method returns a collection of tile IDs through an instance of the IAsyncOperation interface. When the asynchronous operation completes successfully, it returns the collection object through a then or done method.

Examples

The following example retrieves a list of IDs for all secondary tiles created for the calling app and any other app in the same package.



Windows.UI.StartScreen.SecondaryTile.findAllForPackageAsync().done(function (tiles) {
    tiles.forEach(function (tile) {
        var myTileId = tile.tileId;
        // Continue to process as necessary.
    });
});

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
Secondary tiles sample

 

 

Show:
© 2014 Microsoft