VisualElements (Paketschema für Windows 8)
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:
|
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.
|
Dieses Attribut kann einen der folgenden Werte aufweisen:
|
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".
|
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
Schnellstart: Erstellen einer Standardkachel mithilfe des Visual Studio Manifest-Editors
Anforderungen
Wert | |
---|---|
Namespace | http://schemas.microsoft.com/appx/2010/manifest |