Bindung (Kachelschema)
Gibt die Kachelvorlage an. Jede Benachrichtigung sollte ein Bindungselement für jede unterstützte Kachelgröße enthalten.
Elementhierarchie
Syntax
<binding template = tileTemplateNameV2
fallback? = tileTemplateNameV1
lang? = string
baseUri? = anyURI
branding? = "none" | "logo" | "name"
addImageQuery? = boolean
contentId? = string >
<!-- Child elements -->
( image
| text
)*
</binding>
Schlüssel
?
optional (null oder 1) *
optional (null oder mehr)
Attribute und Elemente
Attribute
attribute | BESCHREIBUNG | Datentyp | Erforderlich | Standardwert |
---|---|---|---|---|
addImageQuery | Legen Sie auf true fest, damit Windows eine Abfragezeichenfolge an den in der Kachelbenachrichtigung angegebenen Image-URI anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Images hostet und Abfragezeichenfolgen verarbeiten kann, indem Sie entweder eine Bildvariante basierend auf den Abfragezeichenfolgen abrufen oder die Abfragezeichenfolge ignorieren und das Image wie angegeben ohne die Abfragezeichenfolge zurückgeben. Diese Abfragezeichenfolge gibt Skalierung, Kontrasteinstellung und Sprache an. für instance ein Wert von "www.website.com/images/hello.png" in die Benachrichtigung eingeschlossen wird "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
boolean | Nein | false |
baseUri | Ein Standard-Basis-URI, der mit relativen URIs in Bildquellenattributen kombiniert wird. |
anyURI | No | ms-appx:/// |
Branding | Das Formular, das die Kachel verwenden soll, um die Marke der App anzuzeigen. |
Dieses Attribut kann einen der folgenden Werte annehmen:
|
Nein | Logo |
contentId | Legen Sie auf eine vom Absender definierte Zeichenfolge fest, die den Inhalt der Benachrichtigung eindeutig identifiziert. Dies verhindert Duplikate in der Situation, in der eine große Kachelvorlage die letzten drei breiten Kachelbenachrichtigungen anzeigt. |
Zeichenfolge | No | |
fallback | Eine Vorlage, die verwendet werden soll, wenn der Name der primären Vorlage vom Empfänger nicht erkannt wird, zur Verwendung mit Windows 8 Kompatibilität. Dieser Wert ist der Windows 8 Name des Werts im Template-Attribut. Neue Vorlagen, die nach Windows 8 eingeführt wurden, verfügen nicht über ein Fallback. |
tileTemplateNameV1 (siehe Hinweise) | Nein | Keine |
lang | Das Zielgebietsschema der XML-Nutzlast, die als BCP-47-Sprachtags wie "en-US" oder "fr-FR" angegeben wird. Das hier angegebene Gebietsschema überschreibt dies in visual, kann jedoch von diesem im Text überschrieben werden. Wenn es sich bei diesem Wert um eine Literalzeichenfolge handelt, wird dieses Attribut standardmäßig auf die Benutzeroberflächensprache festgelegt. Wenn es sich bei diesem Wert um einen Zeichenfolgenverweis handelt, wird dieses Attribut standardmäßig auf das Gebietsschema festgelegt, das von Windows-Runtime beim Auflösen der Zeichenfolge ausgewählt wurde. Wenn dieser Wert nicht angegeben ist, finden Sie unter Hinweise. |
Zeichenfolge | Nein | Keine |
Vorlage | Eine der bereitgestellten Vorlagen, auf der die Kachel basieren soll. In der Regel sollte ein Entwickler sowohl ein quadratisches als auch ein breitformatiges Format als separates Bindungselement bereitstellen. Gültige Einträge sind Member der tileTemplateType-Enumeration . |
tileTemplateNameV2 (siehe Hinweise) | Ja | Keine |
Untergeordnete Elemente
Untergeordnetes Element | BESCHREIBUNG |
---|---|
image | Gibt ein In der Kachelvorlage verwendetes Bild an. Das angegebene Bild sollte den Größen- und Formanforderungen für die bestimmte Vorlage oder das jeweilige Bild innerhalb dieser Vorlage entsprechen. |
text | Gibt text an, der in der Kachelvorlage verwendet wird. |
Übergeordnete Elemente
Übergeordnetes Element | BESCHREIBUNG |
---|---|
Visuell | Enthält mehrere untergeordnete Bindungselemente , von denen jedes eine Kachel definiert. |
Hinweise
Der im Template-Attribut verwendete tileTemplateNameV2-Wert kann einer der folgenden Zeichenfolgenwerte sein. Ausführliche Informationen zu den einzelnen Vorlagen finden Sie unter Der Kachelvorlagenkatalog.
- TileSquare150x150Block
- TileSquare150x150Image
- TileSquare150x150PeekImageAndText01
- TileSquare150x150PeekImageAndText02
- TileSquare150x150PeekImageAndText03
- TileSquare150x150PeekImageAndText04
- TileSquare150x150Text01
- TileSquare150x150Text02
- TileSquare150x150Text03
- TileSquare150x150Text04
- TileSquare310x310BlockAndText01
- TileSquare310x310BlockAndText02
- TileSquare310x310Image
- TileSquare310x310ImageAndText01
- TileSquare310x310ImageAndText02
- TileSquare310x310ImageAndTextOverlay01
- TileSquare310x310ImageAndTextOverlay02
- TileSquare310x310ImageAndTextOverlay03
- TileSquare310x310ImageCollection
- TileSquare310x310ImageCollectionAndText01
- TileSquare310x310ImageCollectionAndText02
- TileSquare310x310SmallImagesAndTextList01
- TileSquare310x310SmallImagesAndTextList02
- TileSquare310x310SmallImagesAndTextList03
- TileSquare310x310SmallImagesAndTextList04
- TileSquare310x310Text01
- TileSquare310x310Text02
- TileSquare310x310Text03
- TileSquare310x310Text04
- TileSquare310x310Text05
- TileSquare310x310Text06
- TileSquare310x310Text07
- TileSquare310x310Text08
- TileSquare310x310TextList01
- TileSquare310x310TextList02
- TileSquare310x310TextList03
- TileWide310x150BlockAndText01
- TileWide310x150BlockAndText02
- TileWide310x150Image
- TileWide310x150ImageAndText01
- TileWide310x150ImageAndText02
- TileWide310x150ImageCollection
- TileWide310x150PeekImage01
- TileWide310x150PeekImage02
- TileWide310x150PeekImage03
- TileWide310x150PeekImage04
- TileWide310x150PeekImage05
- TileWide310x150PeekImage06
- TileWide310x150PeekImageAndText01
- TileWide310x150PeekImageAndText02
- TileWide310x150PeekImageCollection01
- TileWide310x150PeekImageCollection02
- TileWide310x150PeekImageCollection03
- TileWide310x150PeekImageCollection04
- TileWide310x150PeekImageCollection05
- TileWide310x150PeekImageCollection06
- TileWide310x150SmallImageAndText01
- TileWide310x150SmallImageAndText02
- TileWide310x150SmallImageAndText03
- TileWide310x150SmallImageAndText04
- TileWide310x150SmallImageAndText05
- TileWide310x150Text01
- TileWide310x150Text02
- TileWide310x150Text03
- TileWide310x150Text04
- TileWide310x150Text05
- TileWide310x150Text06
- TileWide310x150Text07
- TileWide310x150Text08
- TileWide310x150Text09
- TileWide310x150Text10
- TileWide310x150Text11
Der im Fallback-Attribut verwendete tileTemplateNameV1-Wert kann einer der folgenden Zeichenfolgenwerte sein. Dies sind die namen der Windows 8 Vorlagen. Ausführliche Informationen zu den einzelnen Vorlagen finden Sie unter Der Kachelvorlagenkatalog.
- TileSquareBlock
- TileSquareImage
- TileSquarePeekImageAndText01
- TileSquarePeekImageAndText02
- TileSquarePeekImageAndText03
- TileSquarePeekImageAndText04
- TileSquareText01
- TileSquareText02
- TileSquareText03
- TileSquareText04
- TileWideBlockAndText01
- TileWideBlockAndText02
- TileWideImage
- TileWideImageAndText01
- TileWideImageAndText02
- TileWideImageCollection
- TileWidePeekImage01
- TileWidePeekImage02
- TileWidePeekImage03
- TileWidePeekImage04
- TileWidePeekImage05
- TileWidePeekImage06
- TileWidePeekImageAndText01
- TileWidePeekImageAndText02
- TileWidePeekImageCollection01
- TileWidePeekImageCollection02
- TileWidePeekImageCollection03
- TileWidePeekImageCollection04
- TileWidePeekImageCollection05
- TileWidePeekImageCollection06
- TileWideSmallImageAndText01
- TileWideSmallImageAndText02
- TileWideSmallImageAndText03
- TileWideSmallImageAndText04
- TileWideSmallImageAndText05
- TileWideText01
- TileWideText02
- TileWideText03
- TileWideText04
- TileWideText05
- TileWideText06
- TileWideText07
- TileWideText08
- TileWideText09
- TileWideText10
- TileWideText11
In der folgenden Tabelle wird erläutert, wie das System reagiert, wenn lang nicht angegeben wird.
Für ... | Die Systemantwort |
---|---|
Die Sprache für die Benachrichtigung |
Diese Sprache beeinflusst in erster Linie das Layout von Spalten in Vorlagen, die Spalten enthalten. |
Textelemente mit Literaltext |
|
Textelemente mit ms-resource-Inhalt |
Nachdem die Zeichenfolge aufgelöst wurde, wird die Sprache für die aufgelöste Zeichenfolge dem Textelement zugewiesen. Diese Sprache beeinflusst die Textausrichtung (LTR im Vergleich zu RTL) und die Schriftartauswahl für die Benutzeroberfläche. |
ms-appx:/// image |
|
Cloudimages |
Diese Sprache ist in der Abfragezeichenfolge enthalten, wenn addImageQuery true ist. |
Anforderungen
Wert | |
---|---|
Namespace | http://schemas.microsoft.com/notifications/2012/tile.xsd |