Kachel- und Popupbenachrichtigungen für Sprache, Skalierungsfaktor und hohen Kontrast
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.
Ihre Kacheln und Popups können Zeichenfolgen und Bilder laden, die auf die Anzeigesprache, den Anzeigeskalierungsfaktor, hohen Kontrast und andere Laufzeitkontexte zugeschnitten sind. Hintergrundinformationen zur Verwendung von Qualifizierern in den Namen Ihrer Ressourcendateien finden Sie unter Anpassen der Ressourcen für Sprache, Skalierung und andere Qualifizierer und App-Symbole.
Weitere Informationen zu einer Werterhöhung Ihrer App durch Lokalisierung finden Sie unter Globalisierung und Lokalisierung.
In Ihrer Kachel- oder Popupvorlage können Sie mithilfe des ms-resource
URI-Schemas (Uniform Resource Identifier) gefolgt von einem einfachen Zeichenfolgenressourcenbezeichner auf eine Zeichenfolgenressource verweisen. Wenn Sie beispielsweise über eine Resources.resx-Datei verfügen, die einen Ressourceneintrag enthält, dessen Name "Farewell" lautet, verfügen Sie über eine Zeichenfolgenressource mit dem Bezeichner "Farewell". Weitere Informationen zu Zeichenfolgenressourcenbezeichnern und Ressourcendateien (RESW) finden Sie unter Lokalisieren von Zeichenfolgen im UI- und App-Paketmanifest.
So würde ein Verweis auf den Zeichenfolgenressourcenbezeichner "Farewell" im Texttext des Vorlageninhalts mithilfe ms-resource
von .
<text id="1">ms-resource:Farewell</text>
Wenn Sie das ms-resource
URI-Schema weglassen, ist der Texttext nur ein Zeichenfolgenliteral und kein Verweis auf einen Bezeichner.
<text id="1">Farewell</text>
In Ihrer Kachel- oder Popupvorlage können Sie mithilfe des ms-appx
URI-Schemas (Uniform Resource Identifier) gefolgt vom Namen der Bildressource auf eine Bildressource verweisen. Dies ist die gleiche Weise, wie Sie auf eine Bildressource im XAML-Markup verweisen (weitere Details finden Sie unter Referenzieren eines Bilds oder einer anderen Ressource aus XAML-Markup und Code).
Beispielsweise können Sie Ordner wie folgt benennen.
\Assets\Images\contrast-standard\welcome.png
\Assets\Images\contrast-high\welcome.png
In diesem Fall verfügen Sie über eine einzelne Bildressource und ihren Namen (als absoluter Pfad) ist /Assets/Images/welcome.png
. Hier erfahren Sie, wie Sie diesen Namen in Ihrer Vorlage verwenden.
<image id="1" src="ms-appx:///Assets/Images/welcome.png"/>
Beachten Sie, wie in diesem Beispiel-URI das Schema ("ms-appx
") gefolgt von "://
" ist, gefolgt von einem absoluten Pfad (ein absoluter Pfad beginnt mit "/
").
Die ms-resource
Schemas und ms-appx
URI-Schemas führen einen automatischen Qualifiziererabgleich durch, um die Ressource zu finden, die für den aktuellen Kontext am besten geeignet ist. Web-URI-Schemas (z http
. B. , https
, und ftp
) führen keine solchen automatischen Übereinstimmungen durch.
Fügen Sie stattdessen an den URI ihres Bilds eine Abfragezeichenfolge an, die den angeforderten Qualifiziererwert oder -werte beschreibt.
<image id="1" src="http://www.contoso.com/Assets/Images/welcome.png?ms-lang=en-US"/>
Implementieren Sie dann im App-Dienst, der Ihre Bilder bereitstellt, einen HTTP-Handler, der die Abfragezeichenfolge überprüft und verwendet, um zu bestimmen, welches Bild zurückgegeben werden soll.
Außerdem müssen Sie das addImageQuery-Attribut true
in der XML-Nutzlast der Kachel - oder Popupbenachrichtigung festlegen. Das addImageQuery-Attribut wird sowohl in den visual
binding
image
Kachel- als auch in Popupschemas angezeigt. Das explizite Festlegen von "addImageQuery " für ein Element setzt jeden Wert außer Kraft, der auf einem Vorgänger festgelegt ist. Beispielsweise überschreibt ein addImageQuery-Wert true
in einem image
Element ein addImageQuery-Element false
in seinem übergeordneten binding
Element.
Dies sind die Abfragezeichenfolgen, die Sie verwenden können.
Qualifizierer | Abfragezeichenfolge | Beispiel |
---|---|---|
Skalieren | ms-scale | ?ms-scale=400 |
Sprache | ms-lang | ?ms-lang=en-US |
Kontraste | ms-contrast | ?ms-contrast=high |
Eine Referenztabelle aller möglichen Qualifiziererwerte, die Sie in Ihren Abfragezeichenfolgen verwenden können, finden Sie unter ResourceContext.QualifierValues.
- Bildschirmgrößen und Haltepunkte für reaktionsfähiges Design
- Anpassen von Ressourcen für Sprache, Skalierung und andere Qualifizierer
- App-Symbole.
- Globalisierung und Lokalisierung
- Lokalisieren von Zeichenfolgen in der Benutzeroberfläche und im App-Paketmanifest
- Verweisen auf ein Bild oder eine andere Ressource aus XAML-Markup und Code
- addImageQuery
- Kachelschema
- Popupschema