uap:VisualElements (Windows 10)

Artikel
09/03/2023

Beschreibt die visuellen Aspekte der App: Standardkachel, Logobilder, Text- und Hintergrundfarben, Anfängliche Bildschirmausrichtung, Begrüßungsbildschirm und Darstellung der Sperrbildschirmkachel.

Elementhierarchie

<Paket>

<uap:VisualElements>

Syntax

<uap:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    Square44x44Logo = 'A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    AppListEntry = 'An optional string that can have one of the following values: "default" or "none".' >

  <!-- Child elements -->
  uap:DefaultTile?
  & uap:LockScreen?
  & uap:SplashScreen?
  & uap:InitialRotationPreference?

</uap:VisualElements>

Schlüssel

? optionaler (null oder eins) & interleave Connector (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich	Standardwert
DisplayName	Ein Anzeigename für die App, der Benutzern angezeigt werden kann. Diese Zeichenfolge ist lokalisierbar; Weitere Informationen finden Sie unter Hinweise .	Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen. Diese Zeichenfolge kann lokalisiert werden.	Ja
Beschreibung	Die Beschreibung der App. Diese Zeichenfolge ist lokalisierbar; Weitere Informationen finden Sie unter Hinweise .	Eine Zeichenfolge zwischen 1 und 2048 Zeichen.	Yes
BackgroundColor	Gibt die Hintergrundfarbe der App-Kachel an. Farbnamen finden Sie im Abschnitt Hinweise .		Yes
Square150x150Logo	Ein Bild, das als mittlere Kachel des Startbildschirms der App und auf der Aufgabenumschaltung verwendet wird. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter Hinweise.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die mit , oder endet und die folgende Zeichen nicht enthalten kann: `<`, `>`, `:`, `"`, `\|`, `?`oder `*`.`.jpeg.png.jpg` 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.	Yes
Square44x44Logo	Ein Bild, das als kleine Kachel des Startbildschirms der App und in der Liste "Alle Apps" verwendet wird. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter Hinweise.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die mit , oder endet und die folgende Zeichen nicht enthalten kann: `<`, `>`, `:`, `"`, `\|`, `?`oder `*`.`.jpeg.png.jpg` 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.	Yes
AppListEntry	Der Eintrag in der Liste "Alle Apps". Wählen Sie keine für Einstiegspunkte aus, die keine Startmenükacheln benötigen.	Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: "default" oder "none".	No	default

Hinweis

Die hier angegebene Hintergrundfarbe gilt auch für diese Elemente:

Die Schaltflächenfarbe in allen App-eigenen Dialogfeldern
Seite "App-Beschreibung" im Store

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
uap: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 sollen, wird die Kachel auf diesen Standardwert zurückgesetzt.
uap:InitialRotationPreference	Beschreibt die Ausrichtungen, in denen die App für eine optimale Benutzerfreundlichkeit 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. Bei instance wird die App nicht gedreht, wenn die App nur `Landscape` und `LandscapeFlipped` Ausrichtungen angibt und das Gerät zu einer `Portrait` Ausrichtung gedreht wird.
uap:LockScreen	Definiert den Badge und die Benachrichtigungen, die die App auf dem Sperrbildschirm darstellen, der angezeigt wird, wenn das System gesperrt ist.
uap:SplashScreen	Definiert die Darstellung des Begrüßungsbildschirms, der von der App während des Starts angezeigt wird.

Hinweis

Auf Geräten, die nicht rotiert werden können, wird eine App möglicherweise in der Standardausrichtung dieses Geräts angezeigt, 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 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-Eigenschaft geändert werden.

Übergeordnete Elemente

Übergeordnetes Element	BESCHREIBUNG
Anwendung	Stellt eine App dar, die einen Teil oder die gesamte Funktionalität umfasst, die im Paket bereitgestellt wird.

Hinweise

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

Für die Bilder Square150x150Logo und Square44x44Logo können Sie Bilder verschiedener Skalierungen bereitstellen, damit Windows die beste Größe für das 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:

Image-Attribut	Skalieren (Bildgröße in Pixel)
`Applications/Application/VisualElements/@Square150x150Logo`	100 (150x150)
	250 (375x375)
`Applications/Application/VisualElements/@Square44x44Logo`	100 (44x44)
	250 (110x110)
`Applications/Application/VisualElements/@Tall150x310Logo`	100 (150x310)
	250 (375 x 775)

Dies sind die unterstützten Hintergrundfarbnamen:

aliceBlue
antiqueWhite
aqua
aquamarine
azure
beige
bisque
black
blanchedAlmond
blue
blueViolet
brown
burlyWood
cadetBlue
chartreuse
chocolate
coral
CornflowerBlue
cornsilk
crimson
cyan
Dunkelblau
darkCyan
darkGoldenrod

darkGray
darkGreen
darkKhaki
darkMagenta
darkOliveGreen
darkOrange
darkOrchid
darkRed
darkSalmon
darkSeaGreen
darkSlateBlue
darkSlateGray
darkTurquoise
darkViolet
deepPink
deepSkyBlue
dimGray
dodgerBlue
firebrick
floralWhite
forestGreen
fuchsia
gainsboro
ghostWhite

gold
goldenrod
gray
green
Grüngelb
honeydew
Hotpink
indianRed
indigo
ivory
khaki
lavender
lavenderBlush
lawnGreen
lemonChiffon
Hellblau
lightCoral
lightCyan
lightGoldenrodYellow
lightGray
lightGreen
lightPink
lightSalmon
lightSeaGreen

lightSkyBlue
lightSlateGray
lightSteelBlue
lightYellow
lime
limeGreen
linen
magenta
maroon
mediumAquamarin
mediumBlue
mediumOrchid
mediumPurple
mediumSeaGreen
mediumSlateBlue
mediumSpringGreen
mediumTurquoise
mediumVioletRed
midnightBlue
mintCream
mistyRose
moccasin
navajoWhite

navy
oldLace
olive
oliveDrab
orange
orangeRed
orchid
paleGoldenrod
paleGreen
paleTurquoise
paleVioletRed
papayaWhip
peachPuff
peru
pink
plum
powderBlue
purple
Rot
rosyBrown
royalBlue
saddleBrown
salmon

sandyBrown
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 stammt aus dem Paketmanifest eines SDK-Beispiels.

<Applications>
    <Application Id="App" StartPage="default.html">
        <uap:VisualElements 
            DisplayName="ApplicationDataSample"
            Description="Application data sample"
            BackgroundColor="#FFFFFF"               
            Square150x150Logo="images\squareTile-sdk.png" 
            Square44x44Logo="images\smallTile-sdk.png" 
            AppListEntry="default">
            <uap:DefaultTile
                ShowName="allLogos" />
            <uap:LockScreen
                Notification="badge"
                BadgeLogo="images\badgeLogo.png" />
            <uap:SplashScreen
                BackgroundColor="white"
                Image="images\splash-sdk.png" />
            <uap:InitialRotationPreference> 
                <uap:Rotation
                    Preference="portrait" />
            </uap:InitialRotationPreference>            
        </uap:VisualElements>
    </Application>
</Applications>

Weitere Informationen

Anforderungen

Element	Wert
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 Version 1511 (Build 10586)

Freigeben über