VisualElements (Erweiterungsschema für Windows 8.1)

Artikel
07/20/2023

Beschreibt die visuellen Aspekte der UWP-App: Standardkachel, Logobilder, Text- und Hintergrundfarben, Anfangsbildschirmausrichtung, Begrüßungsbildschirm und Darstellung der Sperrbildschirmkachel.

Elementhierarchie

<VisualElements>

Syntax

<VisualElements DisplayName     = A string between 1 and 256 characters in length. This string is localizable. 
                Description     = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
                ForegroundText  = "light" | "dark"
                BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
                ToastCapable?   = boolean
                Logo            = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.
                SmallLogo       = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. >

  <!-- Child elements -->
  ( DefaultTile?
  & LockScreen?
  & SplashScreen
  & InitialRotationPreference?
  )

</VisualElements>

Schlüssel

? optional (null oder eins)

& Interleave-Connector (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attributes

Attribut	BESCHREIBUNG	Datentyp	Erforderlich
BackgroundColor	Gibt die Hintergrundfarbe der App-Kachel an. Informationen zu Farbnamen finden Sie im Abschnitt Hinweise. Beachten Sie, dass die hier angegebene Hintergrundfarbe auch für diese Elemente gilt: Die Schaltflächenfarbe in allen Dialogfeldern im Besitz der App Seite "App-Beschreibung" im Microsoft Store Gilt für Windows Phone: Wenn Sie "transparent" auswählen, wird die Akzentfarbe des Systems verwendet.	Eine Hexadezimalzahl mit drei Byte vor "#" oder einer benannten Farbe.	Ja
Beschreibung	Die Beschreibung der App. Diese Zeichenfolge kann lokalisiert werden. Weitere Informationen finden Sie unter Hinweise.	Eine Zeichenfolge zwischen 1 und 2048 Zeichen, die keine Zeichen wie Registerkarten, Wagenrückläufe und Zeilenvorfühungen enthalten darf.	Ja
DisplayName	Ein Anzeigename für die App, der Benutzern angezeigt werden kann. Diese Zeichenfolge kann lokalisiert werden. Weitere Informationen finden Sie unter Hinweise. Es gibt zwei explizit reservierte Wörter, die nicht als DisplayName für Apps verwendet werden dürfen, die in die Microsoft Store hochgeladen werden: "NoUIEntryPoints" und "NoUIEntryPoints-DesignMode". Diese Bezeichner sind für Entwicklungstools und Testsammlungen reserviert.	Eine Zeichenfolge zwischen 1 und 256 Zeichen. Diese Zeichenfolge kann lokalisiert werden.	Ja
ForegroundText	Gibt die Vordergrundfarbe der App-Kachel an. Gilt für Windows Phone: Wenn Sie "transparent" auswählen, wird die Akzentfarbe des Systems verwendet.	Dieses Attribut kann einen der folgenden Werte aufweisen: ganz dunkel	Ja
Logo	Ein Bild, das als quadratische Kachel der App verwendet wird. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter Hinweise.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die mit ".jpg", ".png" oder ".jpeg" endet, die diese Zeichen nicht enthalten kann: <, >, :, ", \|, ?, oder *. In dieser Zeichenfolge dürfen die Zeichen /und \ nicht das erste oder letzte Zeichen sein. Außerdem kann die Zeichenfolge / oder \ enthalten, aber nicht beides.	Ja
SmallLogo	Ein kleines Bild, das in der Ecke der Kachel angezeigt wird, um die App zu identifizieren. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter Hinweise. Gilt für Windows Phone: Windows Phone unterstützt das kleine Logo auf der Kachel nicht. Sie wird nur in der Liste Apps verwendet.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die mit ".jpg", ".png" oder ".jpeg" endet, die diese Zeichen nicht enthalten kann: <, >, :, ", \|, ?, oder *. In dieser Zeichenfolge dürfen die Zeichen /und \ nicht das erste oder letzte Zeichen sein. Außerdem kann die Zeichenfolge / oder \ enthalten, aber nicht beides.	Ja
ToastCapable	Der Wert true gibt an, dass die App Popupbenachrichtigungen bereitstellen darf. Der Standardwert ist false. Wenn Keine Popupbenachrichtigungen angezeigt werden sollen, geben Sie keinen Wert für dieses Attribut an. Beachten Sie, dass Apps keine Entscheidungen darüber treffen sollten, ob Popupbenachrichtigungen basierend auf diesem Wert gesendet werden sollen.	boolean	Nein

Untergeordnete Elemente

Untergeordnetes Element	BESCHREIBUNG
DefaultTile	Die Standardkachel, die die App auf dem Startbildschirm darstellt. Diese Kachel wird angezeigt, wenn die App zum ersten Mal installiert wird, bevor sie Updatebenachrichtigungen erhalten hat. Wenn für eine Kachel keine Benachrichtigungen angezeigt werden müssen, wird die Kachel auf diese Standardeinstellung zurückgesetzt.
InitialRotationPreference	Beschreibt die Ausrichtungen, in denen die App für eine optimale Benutzererfahrung angezeigt werden soll. Auf einem Gerät, das gedreht werden kann, z. B. einem Tablet, wird die App nicht für Ausrichtungen neu gezeichnet, die hier nicht angegeben sind. Wenn die App beispielsweise nur Querformat- und Querformatausrichtung angibt und das Gerät in hochformatierte Ausrichtung gedreht wird, wird die App nicht gedreht. Beachten Sie, dass eine App auf Geräten, die nicht gedreht werden können, möglicherweise in der Standardausrichtung des Geräts angezeigt wird und die bevorzugte Ausrichtung der App ignoriert wird. Auf einem Gerät, auf dem eine Rotationssperre aktiviert ist, wird die bevorzugte Drehung Ihrer App jedoch weiterhin berücksichtigt. Diese Ausrichtungseinstellungen gelten sowohl für den [Begrüßungsbildschirm](element-splashscreen.md) als auch für die App-Benutzeroberfläche, wenn eine neue Sitzung für Ihre App gestartet wird. Die Einstellungen können während der Laufzeit über die [AutoRotationPreferences](/uwp/api/Windows geändert werden. Graphics.Display.DisplayInformation)-Eigenschaft.
LockScreen	Definiert den Badge und die Benachrichtigungen, die die App auf dem Sperrbildschirm darstellen, die angezeigt werden, wenn das System gesperrt ist.
SplashScreen	Definiert die Darstellung des Begrüßungsbildschirms, der während des Starts von der App angezeigt wird.

Übergeordnete Elemente

Dieses äußerste Element (Dokument) darf nicht in anderen Elementen enthalten sein.

Hinweise

Weitere Informationen zu den Anforderungen an Kacheldimensionen finden Sie unter Kachelgrößen.

Logo - und SmallLogo-Bilder können entweder als direkter Pfad zu einer Bilddatei oder als Ressource angegeben werden. Mithilfe eines Ressourcenverweises können Sie Bilder mit verschiedenen Skalierungen bereitstellen, damit Windows die optimale Größe für das jeweilige Gerät und die Bildschirmauflösung auswählen kann. Sie können auch Bilder mit hohem Kontrast für die Barrierefreiheit sowie lokalisierte Bilder für verschiedene Benutzeroberflächensprachen bereitstellen. Mit diesem Feature können Sie auch die Attribute DisplayName und Description lokalisieren. Weitere Informationen finden Sie im Thema Globalisierung .

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

Die Größenanforderungen für zwei Arten von Logobildern sind hier dargestellt:

Bildattribut Bildgröße in Pixel skalieren Anwendungen\Anwendung\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Anwendungen\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x54

Dies sind die unterstützten Hintergrundfarbnamen:

Name	Name	Name	Name	Name	Name
aliceBlue	zuwhite	aqua	aquamarine	azure	beige
bisque	black	zu veralten	blue	blueViolet	brown
burlyWood	cadetBlue	chartreuse	chocolate	coral	kornflowerBlue
cornsilk	crimson	cyan	Dunkelblau	darkCyan	darkStockenrod
darkGray	darkGreen	darkQiki	darkMagenta	darkOliveGreen	darkOrange
darkOrchid	darkRed	darkSalmon	darkSeaGreen	darkSlateBlue	darkSlateGray
darkTurquoise	darkViolet	deepPink	deepSkyBlue	dimGray	dodgerBlue
firebrick	white	forestGreen	fuchsia	gainsboro	ghostWhite
gold	goldenrod	gray	green	Grüngelb	honeydew
Hotpink	indischRed	indigo	ivory	khaki	lavender
enderBlush	lawnGreen	zuchiffon	Hellblau	lightCoral	lightCyan
lightKapselenrodYellow	lightGreen	lightGray	lightPink	lightSalmon	lightSeaGreen
lightSkyBlue	lightSlateGray	lightSteelBlue	lightYellow	lime	limeGreen
linen	magenta	maroon	mediumAquamarine	mediumBlue	mediumOrchid
mediumPurple	mediumSeaGreen	mediumSlateBlue	mediumSpringGreen	mediumTurquoise	mediumVioletRed
midnightBlue	mintCream	ohne 100000000	moccasin	navajoWhite	navy
oldLace	olive	olivDrab	orange	orangeRed	orchid
bei 100000000000	beigreen	–Turquoise	beivioletRed	;yaWhip	peachPuff
peru	pink	plum	blueBlue	purple	Rot
rosyBrown	royalBlue	–100000000	salmon	durch einen 30-0-000-	seaGreen
Seashell	sienna	silver	Skyblue	slateBlue	slateGray
snow	springGreen	steelBlue	tan	teal	thistle
tomato	transparent	turquoise	violet	wheat	white
Whitesmoke	yellow	yellowGreen

Beispiele

Das folgende Beispiel ist aus dem Paketmanifest eines SDK-Beispiels entnommen.

                    
<Applications>
    <Application Id="App" StartPage="default.html">
        <VisualElements 
            DisplayName="ApplicationDataSample" 
            Logo="images\squareTile-sdk.png" 
            SmallLogo="images\smallTile-sdk.png" 
            Description="Application data sample" 
            ForegroundText="dark" 
            BackgroundColor="#FFFFFF" 
            ToastCapable="false">
            <DefaultTile ShowName="allLogos"/>
            <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
        </VisualElements>
    </Application>
</Applications>

Siehe auch

App-Screenshots und -Bilder

Colors-Klasse

Schnellstart: Erstellen einer Standardkachel mithilfe des Visual Studio Manifest-Editors

Anforderungen

	Wert
Namespace	`http://schemas.microsoft.com/appx/2010/manifest`

Freigeben über