uap:VisualElements

Beschreibt die visuellen Aspekte der App: die Standardkachel, Logobilder, Text- und Hintergrundfarben, die Ausrichtung des Anfangsbildschirms, den Begrüßungsbildschirm und die Darstellung der Kachel auf dem Sperrbildschirm.

Elementhierarchie

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <uap:VisualElements>

Syntax

<uap:VisualElements
  DisplayName = 'A required string between 1 and 256 characters in length. This string is localizable.'
  Description = 'A required string between 1 and 2048 characters in length.'
  BackgroundColor = 'A required value. <!-- TODO: Add description for t:ST_Color -->'
  Square150x150Logo = 'A required 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.'
  Square44x44Logo = 'A required 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.'
  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

? optional (null oder eins)

Attribute

Merkmal Beschreibung Datentyp Erforderlich Standardwert
DisplayName Ein Anzeigename für die App, die Benutzern angezeigt werden kann. Diese Zeichenfolge ist lokalisierbar; weitere Informationen finden Sie in den Hinweisen. Eine Zeichenfolge zwischen 1 und 256 Zeichen länge. Diese Zeichenfolge ist lokalisierbar. Ja
Beschreibung Beschreibung der App. Diese Zeichenfolge ist lokalisierbar; weitere Informationen finden Sie in den Hinweisen. Eine Zeichenfolge zwischen 1 und 2048 Zeichen länge. Ja
BackgroundColor Gibt die Hintergrundfarbe der App-Kachel an. Im Abschnitt "Hinweise " finden Sie Farbnamen. Ein Wert. Ja
Square150x150Logo Ein Bild, das als mittlere Kachel der App auf dem Startbildschirm und auf der Task-Switcher verwendet wird. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie in den Hinweisen. Eine Zeichenfolge zwischen 1 und 256 Zeichen länge, die mit .jpg, , oder .png die nicht diese Zeichen enthalten kann: .jpeg, , , <, , >:, %, ", , &#124;oder ?. * In dieser Zeichenfolge dürfen die / Zeichen \ nicht die ersten oder letzten Zeichen sein. Außerdem kann die Zeichenfolge beide enthalten / oder \ nicht. Ja
Square44x44Logo Ein Bild, das als kleine Kachel auf dem Startbildschirm der App und in der Liste "Alle Apps" verwendet wird. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie in den Hinweisen. Eine Zeichenfolge zwischen 1 und 256 Zeichen länge, die mit .jpg, , oder .png die nicht diese Zeichen enthalten kann: .jpeg, , , <, , >:, %, ", , &#124;oder ?. * In dieser Zeichenfolge dürfen die / Zeichen \ nicht die ersten oder letzten Zeichen sein. Außerdem kann die Zeichenfolge beide enthalten / oder \ nicht. Ja
AppListEntry Der Eintrag in der Liste "Alle Apps". Wählen Sie keine für Einstiegspunkte aus, für die keine Startmenükacheln erforderlich sind. Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Standardwert, keine. No

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
uap:DefaultTile Die Standardkachel, die Ihre App auf dem Startbildschirm darstellt. Die hier angegebenen Symbole werden angezeigt, wenn Ihre App keine Kachelbenachrichtigungen anzeigt. Informationen zum dynamischen Ändern der Darstellung Ihrer Kachel und zum Anzeigen relevanter Liveinhalte finden Sie unter Senden einer lokalen Kachelbenachrichtigung.
uap:LockScreen- Definiert das Signal und die Benachrichtigungen, die die App auf dem Sperrbildschirm darstellen, die angezeigt wird, wenn das System gesperrt ist.
uap:SplashScreen- Definiert die Darstellung des Begrüßungsbildschirms, der während des Starts von der App angezeigt wird.
uap: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. 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.

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
Application Stellt eine App dar, die einen Teil oder alle funktionen umfasst, die im Paket bereitgestellt werden.

Anforderungen

Element Wert
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10
Mindestversion des Betriebssystems Windows 10 Version 1511 (Build 10586)

Bemerkungen

Hinweis

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

  • Die Schaltflächenfarbe in allen Dialogfeldern im Besitz einer App
  • Die Seite "App-Beschreibung" im Store

Hinweis

Auf Geräten, die nicht gedreht 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 Einstellungsoptionen gelten sowohl für den Begrüßungsbildschirm als auch für die App-UI, 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.

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

Für die Square150x150Logo und Square44x44Logo Bilder können Sie Bilder unterschiedlicher Skalierungen bereitstellen, sodass Windows die beste Größe für das Gerät und die Bildschirmauflösung auswählen können. Sie können auch Bilder mit hohem Kontrast für Barrierefreiheit und lokalisierte Bilder bereitstellen, um unterschiedlichen Benutzeroberflächensprachen zu entsprechen. Mit diesem Feature können Sie auch die DisplayName- und Beschreibungsattribute 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 Skalierung (Bildgröße in Pixeln)
Applications/Application/VisualElements/@Square150x150Logo 100 (150x150)
250 (375 x 375)
Applications/Application/VisualElements/@Square44x44Logo 100 (44 x 44)
250 (110x110)
Applications/Application/VisualElements/@Tall150x310Logo 100 (150x310)
250 (375 x 775)

Dies sind die unterstützten Hintergrundfarbnamen:

aliceBlue
antiqueWhite
Aqua
Aquamarin
Azure
Beige
Bisque
schwarz
blanchedAlmond
blau
blueViolet
Braun
burlyWood
CadetBlue
Chartreuse
Schokolade
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
Goldrute
Grau
grün
Grüngelb
Honigtau
Hotpink
indianRed
Indigo
Elfenbein
Khaki
Lavendel
LavendelBlush
lawnGreen
LemonChiffon
Hellblau
lightCoral
lightCyan
lightGoldenrodYellow
lightGray
lightGreen
lightPink
lightSalmon
lightSeaGreen

lightSkyBlue
lightSlateGray
lightSteelBlue
lightYellow
Limone
Kalkgrün
Leinen
magenta
kastanienbraun
mediumAquamarin
mediumBlue
mediumOrchid
mediumPurple
mediumSeaGreen
mediumSlateBlue
mediumSpringGreen
mittelTurquoise
mediumVioletRed
mitternachtsblau
mintCream
mistyRose
Mokassin
navajoWhite

Navy
oldLace
Olive
OliveDrab
Orange
orangeRed
Orchid
paleGoldenrod
blassgrün
paleTurquoise
paleVioletRed
papayaWhip
PfirsichPuff
Peru
pink
Pflaume
Pulverblau
violett
rot
rosyBrown
royalBlue
SattelBrown
Lachs

sandbrown
seaGreen
Seashell
Sienna
Silber
Skyblue
SlateBlue
SlateGray
Schnee
springGreen
SteelBlue
TAN
blaugrün
Thistle
Tomaten
Transparent
Türkis
Violett
Weizen
white
Whitesmoke
gelb
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>

Siehe auch

  • Last updated on