bindung (Kachelschema)

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

Elementhierarchie

<Fliese>
<Visuell>
<Bindung>

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 eins) * optional (null oder mehr)

Attribute und Elemente

Attributes

Attribut BESCHREIBUNG Datentyp Erforderlich Standardwert
addImageQuery

Legen Sie diese Einstellung 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 Bilder hostet und Abfragezeichenfolgen verarbeiten kann, indem entweder eine Bildvariante auf Der Grundlage der Abfragezeichenfolgen abgerufen oder die Abfragezeichenfolge ignoriert und das Bild wie angegeben ohne abfragezeichenfolge zurückgegeben wird. Diese Abfragezeichenfolge gibt Skalierung, Kontrasteinstellung und Sprache an. z. B. ein Wert von

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

in der Benachrichtigung enthalten ist, wird

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

boolean Nein false
baseUri

Ein Standardbasis-URI, der mit relativen URIs in Bildquellattributen kombiniert wird.

anyURI Nein ms-appx:///
Branding

Das Formular, das die Kachel verwenden soll, um die Marke der App anzuzeigen.

Dieses Attribut kann einen der folgenden Werte aufweisen:

  • Keine
  • Logo
  • name
Nein Logo
contentId

Legen Sie auf eine vom Absender definierte Zeichenfolge fest, die den Inhalt der Benachrichtigung eindeutig identifiziert. Dadurch werden Duplikate in Situationen verhindert, in denen eine große Kachelvorlage die letzten drei breiten Kachelbenachrichtigungen anzeigt.

Zeichenfolge Nein
fallback

Eine Vorlage, die verwendet werden soll, wenn der Primäre Vorlagenname vom Empfänger nicht erkannt wird, um mit Windows 8 Kompatibilität verwendet zu werden. Dieser Wert ist der Windows 8 Name des Werts im Vorlagenattribut. Neue Vorlagen, die nach Windows 8 eingeführt wurden, haben keinen Fallback.

tileTemplateNameV1 (siehe Hinweise) Nein Keine
lang

Das Zielschema der XML-Nutzlast, angegeben als BCP-47-Sprachtags wie "en-US" oder "fr-FR". Das hier angegebene Gebietsschema überschreibt dies im Visual, kann jedoch von diesem im Text überschrieben werden. Wenn es sich bei diesem Wert um eine Literalzeichenfolge handelt, wird für dieses Attribut standardmäßig die Benutzeroberflächensprache des Benutzers verwendet. Wenn dieser Wert ein Zeichenfolgenverweis ist, verwendet dieses Attribut standardmäßig das Gebietsschema, das von Windows-Runtime beim Auflösen der Zeichenfolge ausgewählt wurde. Informationen dazu, wann 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 breites 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 Bild an, das in der Kachelvorlage verwendet wird. Das bereitgestellte Bild sollte den Größen- und Formanforderungen für die jeweilige Vorlage oder das Image in dieser Vorlage entsprechen.

text

Gibt den in der Kachelvorlage verwendeten Text an.

 

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
Visuell

Enthält mehrere untergeordnete Bindungselemente , von denen jedes eine Kachel definiert.

 

Hinweise

Der im Vorlagenattribut verwendete tileTemplateNameV2-Wert kann einer der folgenden Zeichenfolgenwerte sein. Ausführliche Informationen zu den einzelnen Vorlagen finden Sie unter Der Katalog der Kachelvorlagen.

  • 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 Fallbackattribut verwendete tileTemplateNameV1-Wert kann einer der folgenden Zeichenfolgenwerte sein. Dies sind die Windows 8 Vorlagennamen. Weitere 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 ist.

Für ... Die Systemantwort
Die Sprache für die Benachrichtigung
  • Wenn explizit festgelegt, verwenden Sie visual.lang oder binding.lang.
  • Andernfalls bestimmt die App-spezifische Spracheinstellung (ggf. die Sprache, in der das [Ressourcenverwaltungssystem](/previous-versions/windows/apps/jj552947(v=win.10)) bestimmt, dass die App unter dem aktuellen Sprachprofil ausgeführt wird.
  • Andernfalls die Sprache des Anzeigenamens auf der Kachel, wie durch Windows-Runtime
  • Andernfalls die Ui-Sprache der Shell (LANGUAGE-Sprache)

Diese Sprache beeinflusst hauptsächlich das Layout von Spalten in Vorlagen, die Spalten enthalten.

Textelemente mit Literaltext
  • Wenn explizit festgelegt, verwenden Sie visual.lang oder binding.lang.
  • Andernfalls bestimmt die App-spezifische Spracheinstellung (ggf. die Sprache, in der das [Ressourcenverwaltungssystem](/previous-versions/windows/apps/jj552947(v=win.10)) bestimmt, dass die App unter dem aktuellen Sprachprofil ausgeführt wird.
  • Andernfalls die Sprache des Anzeigenamens auf der Kachel, wie durch Windows-Runtime
  • Andernfalls die Ui-Sprache der Shell (LANGUAGE-Sprache)
Textelemente mit ms-resource-Inhalt
  • Verwenden Sie bei expliziter Festlegung visual.lang oder binding.lang, und die explizite Sprache wird der Sprachliste des Ressourcenverwaltungssystems [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) vorangestellt, die zum Auflösen der Zeichenfolge verwendet wird.
  • Andernfalls wird [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) als mit dem Sprachprofil des Benutzers initialisiert verwendet.

Nachdem die Zeichenfolge aufgelöst wurde, wird die Sprache für die aufgelöste Zeichenfolge dem Textelement zugewiesen. Diese Sprache formt die Textausrichtung (LTR im Vergleich zu RTL) und die Schriftartauswahl für die Benutzeroberfläche.

ms-appx:///-Image
  • Wenn sie explizit festgelegt ist, verwenden Sie visual.lang oder binding.lang. Die explizite Sprache wird der Sprachliste des Ressourcenverwaltungssystems [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) vorangestellt, die zum Auflösen der Zeichenfolge verwendet wird.
  • Andernfalls wurde [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) als mit dem Sprachprofil des Benutzers initialisiert verwendet.
Cloudimages
  • Wenn explizit festgelegt, verwenden Sie visual.lang oder binding.lang.
  • Andernfalls bestimmt die App-spezifische Spracheinstellung (ggf. die Sprache, die das [Ressourcenverwaltungssystem](/previous-versions/windows/apps/jj552947(v=win.10)) bestimmt, dass die App unter dem aktuellen Sprachprofil ausgeführt wird.
  • Andernfalls wird die Sprache des Anzeigenamens auf der Kachel wie durch Windows-Runtime aufgelöst (möglicherweise nicht festgelegt, wenn der Name sprachneutral ist)
  • Andernfalls die Ui-Sprache der Shell (LANGUAGE-Sprache)

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

 

Anforderungen

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