Freigeben über


Bindung (Kachelschema)

Gibt die Kachelvorlage an. Jede Benachrichtigung sollte ein Bindungselement für jede unterstützte Kachelgröße enthalten.

Elementhierarchie

<tile>
<Visuell>
<binding>

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:

  • Keine
  • Logo
  • name
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
  • Verwenden Sie bei explizitem Festlegen visual.lang oder binding.lang.
  • Andernfalls bestimmt die app-spezifische Spracheinstellung (die Sprache, falls vorhanden, die das [Ressourcenverwaltungssystem](/vorherige-versionen/windows/apps/jj552947(v=win.10)) bestimmt, dass die App unter Berücksichtigung des aktuellen Sprachprofils ausgeführt wird.
  • Andernfalls die Sprache des Anzeigenamens auf der Kachel, die durch Windows-Runtime
  • Andernfalls die Benutzeroberflächensprache der Shell (MUI-Sprache)

Diese Sprache beeinflusst in erster Linie das Layout von Spalten in Vorlagen, die Spalten enthalten.

Textelemente mit Literaltext
  • Verwenden Sie bei explizitem Festlegen visual.lang oder binding.lang.
  • Andernfalls bestimmt die app-spezifische Spracheinstellung (die Sprache, falls vorhanden, die das [Ressourcenverwaltungssystem](/vorherige-versionen/windows/apps/jj552947(v=win.10)) bestimmt, dass die App unter Berücksichtigung des aktuellen Sprachprofils ausgeführt wird.
  • Andernfalls die Sprache des Anzeigenamens auf der Kachel, die durch Windows-Runtime
  • Andernfalls die UI-Sprache der Shell (MUI-Sprache)
Textelemente mit ms-resource-Inhalt
  • Verwenden Sie bei expliziter Festlegung visual.lang oder binding.lang, und die explizite Sprache wird der Sprachliste [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) des Ressourcenverwaltungssystems vorangestellt, um die Zeichenfolge aufzulösen.
  • Andernfalls wird der [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) verwendet, der mit dem Sprachprofil des Benutzers initialisiert wird.

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
  • Verwenden Sie bei expliziter Festlegung visual.lang oder binding.lang die explizite Sprache der Sprachliste [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext), die zum Auflösen der Zeichenfolge verwendet wird.
  • Andernfalls wird die [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) verwendet, wie mit dem Sprachprofil des Benutzers initialisiert.
Cloudimages
  • Verwenden Sie bei explizitem Festlegen visual.lang oder binding.lang.
  • Andernfalls bestimmt die app-spezifische Spracheinstellung (die Sprache, falls vorhanden, die das [Ressourcenverwaltungssystem](/vorherige-versionen/windows/apps/jj552947(v=win.10)) bestimmt, dass die App unter Berücksichtigung des aktuellen Sprachprofils ausgeführt wird.
  • Andernfalls wird die Sprache des Anzeigenamens auf der Kachel durch Windows-Runtime aufgelöst (kann nicht festgelegt werden, wenn der Name sprachneutral ist).
  • Andernfalls die Benutzeroberflächensprache der Shell (MUI-Sprache)

Diese Sprache ist in der Abfragezeichenfolge enthalten, wenn addImageQuery true ist.

 

Anforderungen

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