Kachel- und Popupbenachrichtigungen für Sprache, Skalierungsfaktor und hohen Kontrast

  • Artikel

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.

Verweisen auf eine Zeichenfolgenressource aus einer Vorlage

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-resourcevon .

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

Verweisen auf eine Bildressource aus einer Vorlage

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 "/").

Hosten und Laden von Bildern in der Cloud

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 visualbindingimage 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.

Wichtige APIs