image

Specifies an image used in the tile template. The supplied image should match the size and shape requirements for the specific template or image within that template.

Element hierarchy

<tile>
<visual>
<binding>
<image>

Syntax

<image id             = integer
       src            = string
       alt            = string
       addImageQuery? = boolean />

Key

?   optional (zero or one)

Attributes and Elements

Attributes

AttributeDescriptionData typeRequiredDefault value
addImageQuery

Set to true to allow Windows to append a query string to the image URI supplied in the tile notification. Use this attribute if your server hosts images and can handle query strings, either by retrieving an image variant based on the query strings or by ignoring the query string and returning the image as specified without the query string. This query string specifies scale, contrast setting, and language; for instance, a value of

"www.website.com/images/hello.png"

included in the notification becomes

"www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

booleanNofalse
alt

A description of the image, for users of assistive technologies.

stringNoNone
id

The image element in the tile template that this image is intended for. If a template has only one image, then this value is 1. The number of available image positions is based on the template definition.

integerYesNone
src

The URI of the image source, one of these protocol handlers:

  • http:// or https://

    A web-based image.

  • ms-appx:///

    An image included in the app package.

  • ms-appdata:///local/

    An image saved to local storage.

  • file:///

    A local image. (Supported only for desktop apps. This protocol cannot be used by Windows Store apps.)

stringYesNone

 

Child Elements

None.

Parent Elements

Parent ElementDescription
binding

Specifies the tile template. Every notification should include one binding element for each supported tile size.

 

Requirements

Namespace

http://schemas.microsoft.com/notifications/2012/tile.xsd

 

 

Show:
© 2014 Microsoft