VisualElements (Paketschema für Windows 8)

  • Artikel

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