<VisualElements> Element

Visual aspects of the app that will be displayed on the console.

This element is required.

Syntax

<VisualElements
  DisplayName = string
  Description = string
  ForegroundText = string
  BackgroundColor = string
  Logo = string
  SmallLogo = string >
</VisualElements>  

Attributes

DisplayName
Required. A friendly name for the app. This value is displayed in the collection and used for VUI and should be localized. DisplayName is a string between 1 and 256 characters in length.

DisplayName is also used for voice user interface (VUI) strings in the shell and collection and the global “go to” and “snap” commands.

Titles can also define a short name for use with VUI in the ShortName attribute of DefaultTile element.

Description
Required. The description of the app. This value is displayed in the collection and should be localized. Description is a string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.

ForegroundText
Required. Specifies the foreground color of the app tile. This attribute can have one of the following values: light, dark

BackgroundColor
Required. Specifies the background color of the app tile. BackgroundColor is a three-byte hexadecimal number preceded by “#” or a named color.

Logo
Required. An image used in Most Recently Used (MRU) tiles and pins. Logo is a string between 1 and 256 characters in length that ends with “.png” that cannot contain these characters: <, >, :, “, /, |, ?, or *. The image must meet the following requirements:

• The image must be a PNG with a specified transparent color value
• The bit depth must be 24 bits per pixel
• The image must include the title name
• The image must have a 1:1 aspect ratio
• The image must be 208x208

SmallLogo
Required. A small image used in notification and companion center. Need not be a logo; should resemble your featured promotional square art in that it contains game art without a title. SmallLogo is a string between 1 and 256 characters in length that ends with “.jpg”, “.png”, or “.jpeg” that cannot contain these characters: <, >, :, “, /, |, ?, or *. The image must meet the following requirements:

• The image must be a PNG with a specified transparent color value
• The bit depth must be 24 bits per pixel
• The image must not include the title name
• The image must have a 1:1 aspect ratio
• The image must be 100x100

Element information

Remarks

Application manifest text which will display on the console (VisualElements DisplayName and VisualElements Description attributes) and images containing text (VisualElements Logo, VisualElements SmallLogo, DefaultTile WideLogo, and SplashScreen Image attributes) must be localized. See Localizing Application Manifest Resources for information on localizing application manifest text and images.

Example

<VisualElements 
    DisplayName="Media Application - Tab1"
    Logo="logo.png"
    SmallLogo="smalllogo.png"
    Description="Media Application - Tab1"
    ForegroundText="light"
    BackgroundColor="#464646">

    <DefaultTile ShowName="allLogos" WideLogo="widelogo.png" />
    <SplashScreen Image="splashscreen.png" />
    <mx:ViewStates>
        <mx:ViewState Name="snapped" />
        <mx:ViewState Name="filled" />
    </mx:ViewStates>
</VisualElements>