Kachelinhaltsschema
Hinweis
Live-Kacheln sind ein Windows 10-Feature, das in späteren Versionen von Windows nicht unterstützt wird. Für neue Apps wird empfohlen, die aktuellen Anleitungen für App-Symbole zu befolgen.
Nachstehend werden alle Eigenschaften und Elemente innerhalb von Kachelinhalten beschrieben.
Wenn Sie lieber unformatierte XML anstelle der Benachrichtigungs-Bibliothek verwenden möchten, beziehen Sie sich auf das XML-Schema.
TileContent
TileContent ist das Top-Level-Objekt, das den Inhalt einer Kachelbenachrichtigung einschließlich visueller Objekte beschreibt.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Visuelles Element | ToastVisual | true | Beschreibt den visuellen Teil der Kachelbenachrichtigung. |
TileVisual
Der visuelle Teil der Kacheln enthält die visuellen Spezifikationen für alle Kachelgrößen und weitere visuelle Eigenschaften.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
TileSmall | TileBinding | false | Stellen Sie eine optionale kleine Bindung bereit, um Inhalt für die kleine Kachelgröße anzugeben. |
TileMedium | TileBinding | false | Stellen Sie eine optionale mittlere Bindung bereit, um Inhalt für die mittlere Kachelgröße anzugeben. |
TileWide | TileBinding | false | Stellen Sie eine optionale breite Bindung bereit, um Inhalt für die breite Kachelgröße anzugeben. |
TileLarge | TileBinding | false | Stellen Sie eine optionale große Bindung bereit, um Inhalt für die große Kachelgröße anzugeben. |
Branding | TileBranding | false | Die Form, die die Kachel zum Anzeigen der Marke der App verwenden soll. Erbt standardmäßig das Branding von der Standardkachel. |
DisplayName | Zeichenfolge | false | Eine optionale Zeichenkette zum Überschreiben des Anzeigenamens der Kachel beim Anzeigen dieser Benachrichtigung. |
Argumente | Zeichenfolge | false | Neu im Anniversary Update: App-definierte Daten, die über die TileActivatedInfo-Eigenschaft auf LaunchActivatedEventArgs an Ihre App zurückgegeben werden, wenn der Benutzer Ihre App über die Live Tile startet. Auf diese Weise können Sie erfahren, welche Kachelbenachrichtigungen der Benutzer beim Tippen auf Ihre Live Tile gesehen hat. Auf Geräten ohne Anniversary Update wird dies einfach ignoriert. |
LockDetailedStatus1 | Zeichenfolge | false | Wenn Sie dies angeben, müssen Sie auch eine TileWide-Bindung angeben. Dies ist die erste Textzeile, die auf dem Sperrbildschirm angezeigt wird, wenn der Benutzer die Kachel als detaillierte Status-App ausgewählt hat. |
LockDetailedStatus2 | Zeichenfolge | false | Wenn Sie dies angeben, müssen Sie auch eine TileWide-Bindung angeben. Dies ist die zweite Textzeile, die auf dem Sperrbildschirm angezeigt wird, wenn der Benutzer die Kachel als detaillierte Status-App ausgewählt hat. |
LockDetailedStatus3 | Zeichenfolge | false | Wenn Sie dies angeben, müssen Sie auch eine TileWide-Bindung angeben. Dies ist die dritte Textzeile, die auf dem Sperrbildschirm angezeigt wird, wenn der Benutzer die Kachel als detaillierte Status-App ausgewählt hat. |
BaseUri | URI | false | Eine Standardbasis-URL, die mit relativen URLs in Bildquellenattributen kombiniert wird. |
AddImageQuery | bool? | false | Legen Sie diesen Wert auf „true“ fest, damit Windows eine Abfragezeichenkette an die in der Popupbenachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und mit Abfragezeichenketten umgehen kann, indem er entweder eine Bildvariante basierend auf den Abfragezeichenketten abruft oder die Abfragezeichenkette ignoriert und das Bild wie angegeben ohne die Abfragezeichenkette zurückgibt. Diese Abfragezeichenkette gibt den Maßstab, die Kontrasteinstellung und die Sprache an. Der in der Benachrichtigung angegebene Wert „www.website.com/images/hello.png“ wird zum Beispiel zu „www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us“. |
Sprache | Zeichenfolge | false | Das lokale Ziel der visuellen Payload bei der Verwendung lokalisierter Ressourcen, wird spezifiziert als BCP-47 Sprach-Tags wie „en-US“ oder „fr-FR“. Dieses Gebietsschema wird von jedem Gebietsschema überschrieben, das in Bindung oder Text angegeben ist. Wenn keine Angabe erfolgt, wird stattdessen das Systemgebietsschema verwendet. |
TileBinding
Das Bindungsobjekt enthält den visuellen Inhalt für eine bestimmte Kachelgröße.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Inhalt | ITileBindingContent | false | Der visuelle Inhalt, der auf der Kachel angezeigt werden soll. Einer von TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContentPeople oder TileBindingContentPhotos. |
Branding | TileBranding | false | Die Form, die die Kachel zum Anzeigen der Marke der App verwenden soll. Erbt standardmäßig das Branding von der Standardkachel. |
DisplayName | Zeichenfolge | false | Eine optionale Zeichenkette zum Überschreiben des Anzeigenamens der Kachel für diese Kachelgröße. |
Argumente | Zeichenfolge | false | Neu im Anniversary Update: App-definierte Daten, die über die TileActivatedInfo-Eigenschaft auf LaunchActivatedEventArgs an Ihre App zurückgegeben werden, wenn der Benutzer Ihre App über die Live Tile startet. Auf diese Weise können Sie erfahren, welche Kachelbenachrichtigungen der Benutzer beim Tippen auf Ihre Live Tile gesehen hat. Auf Geräten ohne Anniversary Update wird dies einfach ignoriert. |
BaseUri | URI | false | Eine Standardbasis-URL, die mit relativen URLs in Bildquellenattributen kombiniert wird. |
AddImageQuery | bool? | false | Legen Sie diesen Wert auf „true“ fest, damit Windows eine Abfragezeichenkette an die in der Popupbenachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und mit Abfragezeichenketten umgehen kann, indem er entweder eine Bildvariante basierend auf den Abfragezeichenketten abruft oder die Abfragezeichenkette ignoriert und das Bild wie angegeben ohne die Abfragezeichenkette zurückgibt. Diese Abfragezeichenkette gibt den Maßstab, die Kontrasteinstellung und die Sprache an. Der in der Benachrichtigung angegebene Wert „www.website.com/images/hello.png“ wird zum Beispiel zu „www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us“. |
Sprache | Zeichenfolge | false | Das lokale Ziel der visuellen Payload bei der Verwendung lokalisierter Ressourcen, wird spezifiziert als BCP-47 Sprach-Tags wie „en-US“ oder „fr-FR“. Dieses Gebietsschema wird von jedem Gebietsschema überschrieben, das in Bindung oder Text angegeben ist. Wenn keine Angabe erfolgt, wird stattdessen das Systemgebietsschema verwendet. |
ITileBindingContent
Markierungsschnittstelle für Kachelbindungsinhalte. Hier können Sie wählen, in welchem Format Sie Ihre Kacheln darstellen möchten - adaptiv oder in einer der speziellen Vorlagen.
Implementierungen |
---|
TileBindingContentAdaptive |
TileBindingContentIconic |
TileBindingContentContact |
TileBindingContentPeople |
TileBindingContentPhotos |
TileBindingContentAdaptive
Alle Größen werden unterstützt. Dies ist die empfohlene Methode, um den Kachelinhalt zu spezifizieren. Neue Vorlagen für adaptive Kacheln in Windows 10, und Sie können eine Vielzahl von benutzerdefinierten Kacheln über adaptive Kacheln erstellen.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Children | IList<ITileBindingContentAdaptiveChild> | false | Die visuellen Inline-Elemente. AdaptiveText-, AdaptiveImage- und AdaptiveGroup-Objekte können hinzugefügt werden. Die untergeordneten Elemente werden in einer StackPanel-Sparte angezeigt. |
BackgroundImage | TileBackgroundImage | false | Ein optionales Hintergrundbild, das hinter dem gesamten Kachelinhalt angezeigt wird, und zwar in voller Größe. |
PeekImage | TilePeekImage | false | Ein optionales Vorschau-Bild, das vom oberen Rand der Kachel aus animiert wird. |
TextStacking | TileTextStacking | false | Steuert die Textstapelung (vertikale Ausrichtung) des untergeordneten Inhalts als Ganzes. |
AdaptiveText
Ein adaptives Textelement.
Eigenschaft | Type | Erforderlich | BESCHREIBUNG |
---|---|---|---|
Text | Zeichenfolge | false | Der anzuzeigende Text. |
HintStyle | AdaptiveTextStyle | false | Die Formatvorlage steuert den Schriftgrad, die Gewichtung und die Deckkraft des Texts. |
HintWrap | Bool? | false | Legen Sie diesen Wert auf true fest, um den Textumbruch zu aktivieren. Der Standardwert ist False. |
HintMaxLines | int? | false | Die maximale Anzahl von Zeilen, die das Textelement anzeigen darf. |
HintMinLines | int? | false | Die Mindestanzahl der Zeilen, die das Textelement anzeigen muss. |
HintAlign | AdaptiveTextAlign | false | Gibt die horizontale Ausrichtung des Texts an. |
Sprache | Zeichenfolge | false | Das lokale Ziel der XML-Payload, angegeben als BCP-47 Sprach-Tags wie „en-US“ oder „fr-FR“. Das hier angegebene Gebietsschema hat Vorrang vor allen anderen angegebenen Gebietsschemata, wie z.B. dem in Binding oder Visual. Wenn dieser Wert eine Literalzeichenkette ist, wird dieses Attribut standardmäßig auf die Benutzeroberflächensprache des Benutzers festgelegt. Wenn dieser Wert ein Zeichenkettenverweis ist, wird dieses Attribut standardmäßig auf das Gebietsschema festgelegt, das von Windows-Runtime beim Auflösen der Zeichenkette ausgewählt wurde. |
AdaptiveTextStyle
Der Textstil steuert Schriftgrad, Gewichtung und Deckkraft. Subtile Deckkraft ist 60 % undurchsichtig.
Wert | Bedeutung |
---|---|
Standard | Standardwert. Der Stil wird vom Renderer bestimmt. |
Caption | Kleiner als der Schriftgrad des Absatzes. |
CaptionSubtle | Identisch mit Caption, aber mit dezenter Deckkraft. |
Text | Schriftgrad des Absatzes. |
BodySubtle | Identisch mit Body, aber mit dezenter Deckkraft. |
Bemessungsgrundlage | Schriftgrad des Absatzes, Fettdruckstärke. Im Wesentlichen die fett formatierte Version von Body. |
BaseSubtle | Identisch mit Basis, aber mit dezenter Deckkraft. |
Untertitel | H4 Schriftgrad. |
SubtitleSubtle | Identisch mit Subtitle, aber mit dezenter Deckkraft. |
Titel | H3 Schriftgrad. |
TitleSubtle | Identisch mit Title, aber mit dezenter Deckkraft. |
TitleNumeral | Identisch mit Title, aber ohne obere/untere Füllung. |
Subheader | H2 Schriftgrad. |
SubheaderSubtle | Identisch mit Subheader, aber mit dezenter Deckkraft. |
SubheaderNumeral | Identisch wie Subheader, aber ohne obere/untere Füllung. |
Übergeordnet | H1 Schriftgrad. |
HeaderSubtle | Identisch mit Header, aber mit dezenter Deckkraft. |
HeaderNumeral | Identisch mit Header, aber ohne obere/untere Füllung. |
AdaptiveTextAlign
Steuert die horizontale Ausrichtung von Text.
Wert | Bedeutung |
---|---|
Standard | Standardwert. Die Ausrichtung wird automatisch vom Renderer bestimmt. |
Automatisch | Die Ausrichtung wird durch die aktuelle Sprache und Kultur bestimmt. |
Nach links | Richten Sie den Text horizontal links aus. |
Center | Richten Sie den Text horizontal in der Mitte aus. |
Right | Richten Sie den Text horizontal rechts aus. |
AdaptiveImage
Ein eingebundenes Bild.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Quelle | Zeichenfolge | true | Geben Sie die URL des Bildes ein. ms-appx, ms-appdata und http werden unterstützt. Ab dem Fall Creators Update können Web-Bilder eine Größe von bis zu 3 MB bei normalen Verbindungen und 1 MB bei gebührenpflichtigen Verbindungen haben. Auf Geräten, auf denen das Fall Creators Update noch nicht ausgeführt wird, dürfen Webbilder nicht größer als 200 KB sein. |
HintCrop | AdaptiveImageCrop | false | Überprüfen Sie den gewünschten Zuschnitt des Bilds. |
HintRemoveMargin | Bool? | false | Standardmäßig weisen Bilder innerhalb von Gruppen/Untergruppen einen 8px-Rand um sie herum auf. Sie können diesen Rand entfernen, indem Sie diese Eigenschaft auf true festlegen. |
HintAlign | AdaptiveImageAlign | false | Die horizontale Ausrichtung des Bildes an. |
AlternateText | Zeichenfolge | false | Alternativer Text zur Beschreibung des Bilds, der für Bedienungshilfezwecke verwendet wird. |
AddImageQuery | bool? | false | Legen Sie diesen Wert auf true fest, damit Windows eine Abfragezeichenkette an die in der Kachelbenachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und mit Abfragezeichenketten umgehen kann, indem er entweder eine Bildvariante basierend auf den Abfragezeichenketten abruft oder die Abfragezeichenkette ignoriert und das Bild wie angegeben ohne die Abfragezeichenkette zurückgibt. Diese Abfragezeichenkette gibt den Maßstab, die Kontrasteinstellung und die Sprache an. Der in der Benachrichtigung angegebene Wert „www.website.com/images/hello.png“ wird zum Beispiel zu „www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us“. |
AdaptiveImageCrop
Legt den gewünschten Zuschnitt des Bilds fest.
Wert | Bedeutung |
---|---|
Standard | Standardwert. Das vom Renderer festgelegte Zuschnitt-Verhalten. |
None | Bild ist nicht zugeschnitten. |
Kreis | Das Bild wird auf eine Kreisform zugeschnitten. |
AdaptiveImageAlign
Gibt die horizontale Ausrichtung des Bildes an.
Wert | Bedeutung |
---|---|
Standard | Standardwert. Vom Renderer festgelegtes Ausrichtungsverhalten. |
Stretch | Das Bild wird gestreckt, um die verfügbare Breite zu füllen (und möglicherweise auch die Höhe, je nachdem, wo das Bild platziert wird). |
Nach links | Richten Sie das Bild linksbündig aus, wobei das Bild in seiner systemeigenen Auflösung angezeigt wird. |
Center | Richten Sie das Bild horizontal in der Mitte aus, wobei das Bild in seiner systemeigenen Auflösung angezeigt wird. |
Right | Richten Sie das Bild rechtsbündig aus, wobei das Bild in seiner systemeigenen Auflösung angezeigt wird. |
AdaptiveGroup
Gruppen identifizieren semantisch, dass der Inhalt in der Gruppe entweder als Ganzes angezeigt werden muss oder nicht angezeigt werden kann, wenn er nicht passt. Gruppen ermöglichen auch das Erstellen mehrerer Spalten.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Children | IList<AdaptiveSubgroup> | false | Untergruppen werden als vertikale Spalten angezeigt. Sie müssen Untergruppen verwenden, um Inhalte in einer AdaptiveGroup bereitzustellen. |
AdaptiveSubgroup
Untergruppen sind vertikale Spalten, die Text und Bilder enthalten können.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Children | IList<IAdaptiveSubgroupChild> | false | AdaptiveText und AdaptiveImage sind gültige untergeordnete Elemente von Untergruppen. |
HintWeight | int? | false | Steuern Sie die Breite dieser Untergruppenspalte, indem Sie die Gewichtung in Bezug auf die anderen Untergruppen angeben. |
HintTextStacking | AdaptiveSubgroupTextStacking | false | Steuern der vertikalen Ausrichtung des Inhalts dieser Untergruppe. |
IAdaptiveSubgroupChild
Marker-Schnittstelle für untergeordnete Untergruppen.
Implementierungen |
---|
AdaptiveText |
AdaptiveImage |
AdaptiveSubgroupTextStacking
TextStacking gibt die vertikale Ausrichtung des Inhalts an.
Wert | Bedeutung |
---|---|
Standard | Standardwert. Renderer wählt automatisch die vertikale Standardausrichtung aus. |
Top | Vertikal am oberen Rand ausrichten. |
Center | Vertikal an der Mitte ausrichten. |
bottom | Vertikal am unteren Rand ausrichten. |
TileBackgroundImage
Auf der Kachel wird ein Hintergrundbild mit voller Beschnittzugabe angezeigt.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Quelle | Zeichenfolge | true | Geben Sie die URL des Bildes ein. ms-appx, ms-appdata und http(s) werden unterstützt. HTTP-Bilder dürfen maximal 200 KB groß sein. |
HintOverlay | int? | false | Eine schwarze Überlagerung auf dem Hintergrundbild. Dieser Wert steuert die Deckkraft der schwarzen Überlagerung, wobei 0 keine Überlagerung ist und 100 vollständig schwarz ist. Der Standard liegt bei 20. |
HintCrop | TileBackgroundImageCrop | false | Neu in der Version 1511: Geben Sie an, wie das Bild zugeschnitten werden soll. In Versionen vor 1511 wird dies ignoriert, und das Hintergrundbild wird ohne Zuschnitt angezeigt. |
AlternateText | Zeichenfolge | false | Alternativer Text zur Beschreibung des Bilds, der für Bedienungshilfezwecke verwendet wird. |
AddImageQuery | bool? | false | Legen Sie diesen Wert auf true fest, damit Windows eine Abfragezeichenkette an die in der Kachelbenachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und mit Abfragezeichenketten umgehen kann, indem er entweder eine Bildvariante basierend auf den Abfragezeichenketten abruft oder die Abfragezeichenkette ignoriert und das Bild wie angegeben ohne die Abfragezeichenkette zurückgibt. Diese Abfragezeichenkette gibt den Maßstab, die Kontrasteinstellung und die Sprache an. Der in der Benachrichtigung angegebene Wert „www.website.com/images/hello.png“ wird zum Beispiel zu „www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us“. |
TileBackgroundImageCrop
Steuert den Zuschnitt des Hintergrundbilds.
Wert | Bedeutung |
---|---|
Standard | Beim Zuschneiden wird das Standardverhalten des Renderers verwendet. |
None | Bild ist nicht zugeschnitten, angezeigtes Quadrat. |
Kreis | Das Bild wird auf eine Kreisform zugeschnitten. |
TilePeekImage
Ein Vorschau-Bild, das vom oberen Rand der Kachel aus animiert wird.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Quelle | Zeichenfolge | true | Geben Sie die URL des Bildes ein. ms-appx, ms-appdata und http(s) werden unterstützt. HTTP-Bilder dürfen maximal 200 KB groß sein. |
HintOverlay | int? | false | Neu in 1511: Eine schwarze Überlagerung auf dem Vorschaubild. Dieser Wert steuert die Deckkraft der schwarzen Überlagerung, wobei 0 keine Überlagerung ist und 100 vollständig schwarz ist. Der Standard liegt bei 20. In früheren Versionen wird dieser Wert ignoriert, und das Vorschaubild wird mit einer Überlagerung von 0 angezeigt. |
HintCrop | TilePeekImageCrop | false | Neu in der Version 1511: Geben Sie an, wie das Bild zugeschnitten werden soll. In Versionen vor 1511 wird dies ignoriert, und das Vorschaubild wird ohne Zuschnitt angezeigt. |
AlternateText | Zeichenfolge | false | Alternativer Text zur Beschreibung des Bilds, der für Bedienungshilfezwecke verwendet wird. |
AddImageQuery | bool? | false | Legen Sie diesen Wert auf true fest, damit Windows eine Abfragezeichenkette an die in der Kachelbenachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und mit Abfragezeichenketten umgehen kann, indem er entweder eine Bildvariante basierend auf den Abfragezeichenketten abruft oder die Abfragezeichenkette ignoriert und das Bild wie angegeben ohne die Abfragezeichenkette zurückgibt. Diese Abfragezeichenkette gibt den Maßstab, die Kontrasteinstellung und die Sprache an. Der in der Benachrichtigung angegebene Wert „www.website.com/images/hello.png“ wird zum Beispiel zu „www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us“. |
TilePeekImageCrop
Steuert das Zuschneiden des Vorschaubilds.
Wert | Bedeutung |
---|---|
Standard | Beim Zuschneiden wird das Standardverhalten des Renderers verwendet. |
None | Bild ist nicht zugeschnitten, angezeigtes Quadrat. |
Kreis | Das Bild wird auf eine Kreisform zugeschnitten. |
TileTextStacking
Text-Stapel gibt die vertikale Ausrichtung des Inhalts an.
Wert | Bedeutung |
---|---|
Standard | Standardwert. Renderer wählt automatisch die vertikale Standardausrichtung aus. |
Top | Vertikal am oberen Rand ausrichten. |
Center | Vertikal an der Mitte ausrichten. |
bottom | Vertikal am unteren Rand ausrichten. |
TileBindingContentIconic
Wird von Klein und Mittel unterstützt. Ermöglicht eine Iconic-Kachelvorlage, in der Sie ein Symbol und ein Badge nebeneinander auf der Kachel im klassischen Windows-Telefon-Stil anzeigen können. Die Zahl neben dem Symbol wird über eine separate Badge-Benachrichtigung erreicht.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Symbol: | TileBasicImage | true | Um sowohl kleine als auch mittlere Kacheln für Desktop und Mobilgeräte zu unterstützen, sollten Sie mindestens ein Bild mit quadratischem Seitenverhältnis und einer Auflösung von 200x200 im PNG-Format bereitstellen, das transparent ist und keine andere Farbe als Weiß hat. Weitere Informationen finden Sie unter: Spezielle Kachelvorlagen. |
TileBindingContentContact
Nur Mobilgeräte. Wird von Klein, Mittel und Breit unterstützt.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Abbildung | TileBasicImage | true | Das auf dem Display angezeigte Bild. |
Text | TileBasicText | false | Eine Textzeile, die angezeigt wird. Wird nicht auf kleiner Kachel angezeigt. |
TileBindingContentPeople
Neu in 1511: Unterstützt auf Mittel, Breit und Groß (Desktop und Mobilgeräte). Zuvor war diese Funktion nur für Mobilgeräte und nur für Mittel und Breit verfügbar.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Bilder | IList<TileBasicImage> | true | Bilder, die sich als Kreise bewegen. |
TileBindingContentPhotos
Animiert durch eine Bildschirmpräsentation von Fotos. Alle Größen werden unterstützt.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Bilder | IList<TileBasicImage> | true | Bis zu 12 Bilder können bereitgestellt werden (Für Mobilgeräte werden nur bis zu 9 angezeigt), die für die Bildschirmpräsentation verwendet werden. Wenn Sie mehr als 12 hinzufügen, wird eine Ausnahme ausgelöst. |
TileBasicImage
Ein Bild, das für verschiedene spezielle Vorlagen verwendet wird.
Eigenschaft | Type | Erforderlich | Beschreibung |
---|---|---|---|
Quelle | Zeichenfolge | true | Geben Sie die URL des Bildes ein. ms-appx, ms-appdata und http(s) werden unterstützt. HTTP-Bilder dürfen maximal 200 KB groß sein. |
AlternateText | Zeichenfolge | false | Alternativer Text zur Beschreibung des Bilds, der für Bedienungshilfezwecke verwendet wird. |
AddImageQuery | bool? | false | Legen Sie diesen Wert auf true fest, damit Windows eine Abfragezeichenkette an die in der Kachelbenachrichtigung angegebene Bild-URL anfügen kann. Verwenden Sie dieses Attribut, wenn Ihr Server Bilder hostet und mit Abfragezeichenketten umgehen kann, indem er entweder eine Bildvariante basierend auf den Abfragezeichenketten abruft oder die Abfragezeichenkette ignoriert und das Bild wie angegeben ohne die Abfragezeichenkette zurückgibt. Diese Abfragezeichenkette gibt den Maßstab, die Kontrasteinstellung und die Sprache an. Der in der Benachrichtigung angegebene Wert „www.website.com/images/hello.png“ wird zum Beispiel zu „www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us“. |
TileBasicText
Ein einfaches Textelement, das für verschiedene spezielle Vorlagen verwendet wird.
Eigenschaft | Type | Erforderlich | BESCHREIBUNG |
---|---|---|---|
Text | Zeichenfolge | false | Der anzuzeigende Text. |
Sprache | Zeichenfolge | false | Das lokale Ziel der XML-Payload, angegeben als BCP-47 Sprach-Tags wie „en-US“ oder „fr-FR“. Das hier angegebene Gebietsschema hat Vorrang vor allen anderen angegebenen Gebietsschemata, wie z.B. dem in Binding oder Visual. Wenn dieser Wert eine Literalzeichenkette ist, wird dieses Attribut standardmäßig auf die Benutzeroberflächensprache des Benutzers festgelegt. Wenn dieser Wert ein Zeichenkettenverweis ist, wird dieses Attribut standardmäßig auf das Gebietsschema festgelegt, das von Windows-Runtime beim Auflösen der Zeichenkette ausgewählt wurde. |