Share via

SecondaryTileVisualElements Class

  • Reference

Definition

Namespace:
Windows.UI.StartScreen
Edit

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:

public ref class SecondaryTileVisualElements sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class SecondaryTileVisualElements final
/// [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.Standard)]
public sealed class SecondaryTileVisualElements
[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.

Applies to