Windows Dev Center

SecondaryTile.SecondaryTile constructors

Creates a SecondaryTile object.

Overload list

ConstructorDescription
SecondaryTile() Creates a SecondaryTile object. The caller must then set any mandatory properties through the object before attempting to pin, update, or delete the tile.
SecondaryTile(String) Creates a SecondaryTile object with a specific ID. This form of the constructor should be used to create a secondary tile object to perform a tile update or deletion.
SecondaryTile(String, String, String, Uri, TileSize) Creates a SecondaryTile object that includes all of the mandatory properties required to create a medium tile.
SecondaryTile(String, String, String, String, TileOptions, Uri) Creates a SecondaryTile object as a medium tile.
SecondaryTile(String, String, String, String, TileOptions, Uri, Uri) Creates a SecondaryTile object as a wide tile.

Remarks

To pin a secondary tile to the Start screen, a minimum set of properties must be defined before the pin or unpin request is made. If you don't, the pinning action fails. The following table summarizes the property values needed for specific actions and the best constructor to use in each situation.

Desired resultRequired propertiesConstructor
Pinning a medium secondary tile to the Start screen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize)
Pinning a wide secondary tile to the Start screen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize)
Pinning a small secondary tile to the Start screen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize)
Pinning a large secondary tile to the Start screen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize)
Unpinning a secondary tile SecondaryTile(String)
Updating a secondary tile SecondaryTile(String) plus one or more of the SecondaryTile or SecondaryTileVisualElements properties that are being updated.

 

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

 

 

Show:
© 2015 Microsoft