SecondaryTileVisualElements Class

Definition

Namespace:

Windows.UI.StartScreen

Contains properties through which you can get or set a secondary tile's background color, foreground text, tile images, and app name display options. The properties in this class replace these SecondaryTile properties:

• SecondaryTile.BackgroundColor
• SecondaryTile.ForegroundText
• SecondaryTile.Logo
• SecondaryTile.SmallLogo
• SecondaryTile.WideLogo
• SecondaryTile.TileOptions (except CopyOnDeployment)

public ref class SecondaryTileVisualElements sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SecondaryTileVisualElements final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SecondaryTileVisualElements

Public NotInheritable Class SecondaryTileVisualElements

Inheritance

Object Platform::Object IInspectable SecondaryTileVisualElements

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

This class object is obtained by calling the SecondaryTile.VisualElements property.

A logo image that is saved locally (ms-appdata://localfolder/) by the app to use in a secondary tile should not be deleted by the app. This prevents loss of the image if the cache is cleared.

Version history

Windows version	SDK version	Value added
1709	16299	MixedRealityModel

Properties

BackgroundColor	Gets or sets the secondary tile's background color.
ForegroundText	Specifies whether the tile should use dark or light text. This value is ignored on Windows Phone 8.1. The foreground text color of a secondary tile on the phone is always light.
MixedRealityModel	Gets an object representing a 3D model asset for use as an app launcher in the Windows Mixed Reality home environment.
ShowNameOnSquare150x150Logo	Specifies whether the display name should be shown on the medium secondary tile. The display name is never shown on a medium secondary tile on Windows Phone 8.1, so this value is ignored.
ShowNameOnSquare310x310Logo	Specifies whether the display name should be shown on the large secondary tile. The large tile size is not supported on Windows Phone 8.1, so this value is ignored.
ShowNameOnWide310x150Logo	Specifies whether the display name should be shown on the wide secondary tile.
Square150x150Logo	Gets or sets the medium secondary tile image.
Square30x30Logo	Gets or sets the square30x30 secondary tile image. The Square30x30 tile size is not supported on Windows Phone 8.1.
Square310x310Logo	Gets or sets the large secondary tile image. The large tile size is not supported on Windows Phone 8.1.
Square44x44Logo	Gets or sets the square44x44 secondary tile image.
Square70x70Logo	Gets or sets the small secondary tile image. The Square70x70 tile size is not supported on Windows Phone 8.1. Instead, call Square71x71Logo.
Square71x71Logo	Gets or sets the small secondary tile image. The Square71x71 tile size is not supported on Windows. Instead, call Square70x70Logo.
Wide310x150Logo	Gets or sets the wide secondary tile image.