visual (Kachelschema)

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

Elementhierarchie

<Fliese>
<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 eins) + erforderlich (mindestens eins)

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

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

Die Version des KACHEL-XML-Schemas, für das diese spezielle 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 Fallbackattribut des Bindungselements.

integer Nein 1

 

Untergeordnete Elemente

Untergeordnetes Element BESCHREIBUNG
Bindung

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

 

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
Fliese

Basiskachelelement, das ein einzelnes visuelles Element enthält.

 

Hinweise

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.
  • Anderfalls die app-spezifische Spracheinstellung (sofern dies die Sprache ist, in der das [Ressourcenverwaltungssystem](/previous-versions/windows/apps/jj552947(v=win.10)) bestimmt, dass die App unter Bzw. dem aktuellen Sprachprofil ausgeführt wird.
  • Ander denn, die Sprache des Anzeigenamens auf der Kachel wird durch Windows-Runtime aufgelöst (wird möglicherweise nicht festgelegt, wenn der Name sprachneutral ist).
  • Anderens die Benutzeroberflächensprache der Shell (LANGUAGE SHELL)

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

 

Anforderungen

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