Specifies the tile template.
Element hierarchy
Syntax
<binding template = "TileSquareImage" | "TileSquareBlock" | "TileSquareText01" | "TileSquareText02" | ...
fallback? = string
lang? = string
baseUri? = anyURI
branding? = "none" | "logo" | "name"
addImageQuery? = boolean >
<!-- Child elements -->
( image
| text
)*
</binding>
Key
- ? optional (zero or one)
- * optional (zero or more)
Attributes and Elements
Attributes
| Attribute | Description | Data type | Required | Default 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" given in the notification becomes "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" | boolean | No | false |
| baseUri |
A default base URI that is combined with relative URIs in image source attributes. | URI | No | ms-appx:/// |
| branding |
The form that the tile should use to display the app's brand. |
This attribute can have one of the following values:
| No | logo |
| fallback |
A template to use if the primary template cannot be found, for use with backward compatibility. | string | No | None |
| lang |
The target locale of the XML payload, specified as a BCP-47 language code such as "en-US" or "fr-FR". The locale specified here overrides that in visual, but can be overriden by that in text. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string. The Remarks on visual apply to this attribute as well. | string | No | None |
| template |
One of the provided templates on which to base the tile. Typically, a developer should supply both a square and a wide format, each as a separate binding element. Valid entries are members of the tileTemplateType enumeration. |
This attribute can have one of the following values:
| Yes | None |
Child Elements
| Child Element | Description |
|---|---|
| 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. |
| text |
Specifies text used in the tile template. |
Parent Elements
| Parent Element | Description |
|---|---|
| visual |
Contains multiple binding child elements, each of which defines a tile. |
Requirements
|
Namespace |
http://schemas.microsoft.com/notifications/2012/tile.xsd |
|---|
Build date: 10/26/2012
