visual (Kachelschema)

  • Artikel

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

Elementhierarchie

<tile>
<Visuell>

Syntax

<visual version?       = integer
        lang?          = string
        baseUri?       = anyURI
        branding?      = "none" | "logo" | "name"
        addImageQuery? = boolean
        contentId?     = string >

  <!-- Child elements -->
  binding+

</visual>

Schlüssel

? optional (null oder 1) + erforderlich (mindestens eine)

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 Keine
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 Nein Keine
lang

Das Zielgebietsschema der XML-Nutzlast, die als BCP-47-Sprachtags wie "en-US" oder "fr-FR" angegeben wird. Dieses Gebietsschema wird von jedem gebietsschema überschrieben, das in Bindung oder Text angegeben ist. 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
version

Die Version des XML-Kachelschemas, für das diese bestimmte Nutzlast entwickelt wurde. Sie kann zwei Werte aufweisen, 1 oder 2. Version 1 erfordert eine gültige Nutzlast unter dem Windows 8 Schema. Version 2 erkennt die neuen großen Kachelvorlagen, die neuen Windows 8.1 Vorlagennamen für vorhandene Vorlagen und das Fallback-Attribut des Bindungselements.

 integer Nein 1

 

Untergeordnete Elemente

Untergeordnetes Element BESCHREIBUNG
binding

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

 

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
tile

Basiskachelelement, das ein einzelnes visuelles Element enthält.

 

Hinweise

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 appspezifische Spracheinstellung (ggf. die Sprache, in der [Ressourcenverwaltungssystem](/previous-versions/windows/apps/jj552947(v=win.10)) 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 (möglicherweise nicht festgelegt, wenn der Name sprachneutral ist).
  • Andernfalls die Benutzeroberflächensprache der Shell (MUI-Sprache)

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

 

Anforderungen

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