VisualElements (Paketschema für Windows 8)

Artikel
07/20/2023

Beschreibt die visuellen Aspekte der UWP-App: die Standardkachel, Logobilder, Text- und Hintergrundfarben, die Anfängliche Bildschirmausrichtung, den Begrüßungsbildschirm und die Darstellung der Kachel für sperrbildschirme.

Elementhierarchie

<Paket>

<Anwendungen>

<Application>: <VisualElements>

Syntax

<VisualElements DisplayName     = A string between 1 and 256 characters in length.
                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.
                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 >

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

</VisualElements>

Schlüssel

? optional (null oder eins)

& Verbinder zwischenspeichern (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attribute

Attribut	BESCHREIBUNG	Datentyp	Erforderlich
BackgroundColor	Gibt die Hintergrundfarbe der App-Kachel an. Weitere Informationen finden Sie im Abschnitt "Hinweise" für Farbnamen. Beachten Sie, dass die hier angegebene Hintergrundfarbe auch für diese Elemente gilt: Die Schaltflächenfarbe in allen Dialogfeldern im Besitz einer App Die Seite "App-Beschreibung" in der Microsoft Store Gilt für Windows Phone: Durch auswählen von "transparent" wird die Systemakzentfarbe verwendet.	Eine hexadezimale Zahl mit drei Byte vor "#" oder einer benannten Farbe.	Ja
Beschreibung	Die Beschreibung der App. Diese Zeichenfolge ist lokalisierbar; Weitere Informationen finden Sie unter "Hinweise".	Eine Zeichenfolge zwischen 1 und 2048 Zeichen länge, die keine Zeichen wie Registerkarten, Wagenrücklauf und Zeilenfeeds enthalten können.	Ja
DisplayName	Ein Anzeigename für die App, die benutzern angezeigt werden kann. Diese Zeichenfolge ist lokalisierbar; Weitere Informationen finden Sie unter "Hinweise". Es gibt zwei explizit reservierte Wörter, die möglicherweise nicht als DisplayName für Apps verwendet werden, die in die Microsoft Store hochgeladen wurden: "NoUIEntryPoints" und "NoUIEntryPoints-DesignMode". Diese Bezeichner sind für Entwicklungstools und Testsammlungen reserviert.	Eine Zeichenfolge zwischen 1 und 256 Zeichen länge.	Ja
ForegroundText	Gibt die Vordergrundfarbe der App-Kachel an. Gilt für Windows Phone: Dieser Wert wird ignoriert. Alle Kacheln verwenden die Helltextfarbe.	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 können die Zeichen / und \ nicht die ersten oder letzten Zeichen sein. Außerdem kann die Zeichenfolge / oder \ enthalten, aber nicht beide.	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 zeigt das kleine Logo auf der Kachel nicht an. 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 können die Zeichen / und \ nicht die ersten oder letzten Zeichen sein. Außerdem kann die Zeichenfolge / oder \ enthalten, aber nicht beide.	Ja
ToastCapable	Ein Wert von true gibt an, dass die App Popupbenachrichtigungen bereitstellen darf. Der Standardwert ist false. Wenn Popupbenachrichtigungen nicht 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 zuerst installiert wird, bevor sie Aktualisierungsbenachrichtigungen erhalten hat. Wenn eine Kachel keine Benachrichtigungen enthält, wird die Kachel auf diese Standardeinstellung zurückgesetzt.
InitialRotationPreference	Beschreibt die Ausrichtungen, in denen die App für die beste Benutzererfahrung angezeigt werden soll. Auf einem Gerät, das gedreht werden kann, z. B. ein Tablet, wird die App nicht für Ausrichtungen neu gezeichnet, die hier nicht angegeben sind. Wenn die App beispielsweise nur Quer- und Querformat-Ausrichtungen angibt und das Gerät in eine Hochformatausrichtung gedreht wird, wird die App nicht gedreht. Beachten Sie, dass auf Geräten, die nicht gedreht werden können, eine App möglicherweise in der Standardausrichtung dieses Geräts angezeigt wird, und die bevorzugte Ausrichtung der App wird ignoriert. Auf einem Gerät mit aktivierter Drehungssperre 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.DisplayProperties) -Eigenschaft.
LockScreen	Definiert das Signal und die Benachrichtigungen, die die App auf dem Sperrbildschirm darstellen, die angezeigt wird, wenn das System gesperrt ist.
SplashScreen	Definiert das Aussehen des Begrüßungsbildschirms, der während des Startvorgangs von der App angezeigt wird.

Übergeordnete Elemente

Übergeordnetes Element	BESCHREIBUNG
Anwendung	Stellt eine App dar, die Einen Teil oder alle Funktionen umfasst, die im Paket bereitgestellt werden.

Hinweise

Weitere Informationen zu den Anforderungen an die Kacheldimension 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 von zwei Arten von Logobildern werden hier gezeigt:

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

Dies sind die unterstützten Hintergrundfarbnamen:

Name	Name	Name	Name	Name	Name
aliceBlue	antikeWhite	aqua	aquamarine	azure	beige
bisque	black	blanchedAlmond	blue	blueViolet	brown
burlyWood	cadetBlue	chartreuse	chocolate	coral	CornflowerBlue
cornsilk	crimson	cyan	Dunkelblau	darkCyan	darkGoldenrod
darkGray	dunkelgrün	darkKhaki	darkMagenta	darkOliveGreen	darkOrange
darkOrchid	darkRed	darkSalmon	darkSeaGreen	darkSlateBlue	darkSlateGray
darkTurquoise	darkViolet	deepPink	deepSkyBlue	dimGray	dodgerBlue
firebrick	blumenwhite	forestGreen	fuchsia	gainsboro	ghostWhite
gold	goldenrod	gray	green	Grüngelb	honeydew
Hotpink	indischenRed	indigo	ivory	khaki	lavender
lavaBlush	lawnGreen	LemonChiffon	Hellblau	lightCoral	lightCyan
lightGoldenrodYellow	lightGreen	lightGray	lightPink	lightSalmon	lightSeaGreen
lightSkyBlue	lightSlateGray	lightSteelBlue	lightYellow	lime	limeGreen
linen	magenta	maroon	mediumAquamarin	mediumBlue	mediumOrchid
mediumPurple	mediumSeaGreen	mediumSlateBlue	mediumSpringGreen	mediumTurquoise	mediumVioletRed
MitternachtBlue	mintCream	mistyRose	moccasin	navajoWhite	navy
oldLace	olive	OliveDrab	orange	orangeRed	orchid
paleGoldenrod	paleGreen	paleTurquoise	paleVioletRed	papayaWhip	Pfirsichpuff
peru	pink	plum	pulverBlue	purple	Rot
rosyBrown	royalBlue	sattelBrown	salmon	sandBrown	seaGreen
Seashell	sienna	silver	Skyblue	slateBlue	slateGray
snow	springGreen	StahlBlue	tan	teal	thistle
tomato	transparent	turquoise	violet	wheat	white
Whitesmoke	yellow	gelbGreen

Beispiele

Im folgenden Beispiel wird das Paketmanifest eines SDK-Beispiels verwendet.

                    
<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

Farbenklasse

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

Anforderungen

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

Freigeben über