Freigeben über

uap3:VisualElements (Windows 10)

  • Artikel

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

Elementhierarchie

<Paket>

      <Anwendungen>

            <Anwendung>

                  <uap3:VisualElements>

Syntax

<uap3:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters in length. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters in length.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string with a value 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 with a value 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".' 
    VisualGroup = 'A string with a value between 1 and 256 characters in length that does not contain backslashes ("\").' />

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

</uap3:VisualElements>

Schlüssel

? optionaler Interleave-Connector (null oder 1) & (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 kann lokalisiert werden. Weitere Informationen finden Sie unter Hinweise. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge. Diese Zeichenfolge kann lokalisiert werden. Ja
Beschreibung Die Beschreibung der App. Diese Zeichenfolge kann lokalisiert werden. Weitere Informationen finden Sie unter Hinweise . Eine Zeichenfolge zwischen 1 und 2048 Zeichen länge. Yes
BackgroundColor Gibt die Hintergrundfarbe der App-Kachel an. Eine hexadezimale Zahl mit # drei Byte vor oder einer benannten Farbe. Eine Liste benannter Farben finden Sie unter Hinweise . Yes
Square150x150Logo Ein Bild, das als mittlere Kachel für den Startbildschirm der App und auf dem Aufgabenumschalter verwendet wird. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter Hinweise. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge, die mit .jpgendet, .pngoder .jpeg , die die folgenden Zeichen nicht enthalten kann: <, , >, :, ", , |, ?oder *. In dieser Zeichenfolge dürfen die / Zeichen und \ nicht das erste oder letzte Zeichen sein. Außerdem kann die Zeichenfolge oder, \ aber nicht beides enthalten/. Yes
Square44x44Logo Ein Bild, das als kleine Kachel "Startbildschirm" 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 mit einem Wert zwischen 1 und 256 Zeichen Länge, die mit .jpgendet, .pngoder .jpeg , die die folgenden Zeichen nicht enthalten kann: <, , >, :, ", , |, ?oder *. In dieser Zeichenfolge dürfen die / Zeichen und \ nicht das erste oder letzte Zeichen sein. Außerdem kann die Zeichenfolge oder, \ aber nicht beides enthalten/. Yes
AppListEntry Der Eintrag in der Liste "Alle Apps". Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: default oder none. No
VisualGroup Der Name eines Ordners, der in der Liste "Alle Apps" erstellt werden soll, in dem die Kachel für die App gespeichert werden soll. Eine Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge, die keine umgekehrten Schrägstriche (\) oder Leerzeichen enthält. Nein

Hinweis

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

  • Die Schaltflächenfarbe in allen Dialogfeldern, die der App gehören.
  • Die Seite App-Beschreibung im Store.

Untergeordnete Elemente

Untergeordnetes Element BESCHREIBUNG
uap:DefaultTile Definiert die Standardkachel, die die App auf dem Startbildschirm darstellt. Diese Kachel wird angezeigt, wenn die App zum ersten Mal installiert wird, bevor sie Aktualisierungsbenachrichtigungen erhalten hat. Wenn auf einer Kachel keine Benachrichtigungen angezeigt werden müssen, wird die Kachel auf diese Standardeinstellung zurückgesetzt.
uap:LockScreen Definiert das Signal und die Benachrichtigungen, die die App auf dem Sperrbildschirm darstellen. Dies wird angezeigt, wenn das System gesperrt ist.
uap:SplashScreen Definiert die Darstellung des Begrüßungsbildschirms, der von der App beim Start angezeigt wird.
uap:InitialRotationPreference Beschreibt die Ausrichtungen, in denen die App für die beste Benutzererfahrung angezeigt werden soll.

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
Anwendung Stellt eine App dar, die einen Teil der im Paket bereitgestellten Funktionen oder alle umfasst.

Hinweise

Sie können das VisualGroup-Attribut nicht verwenden, um eine Struktur geschachtelter Ordner zu erstellen. Wenn Sie einen umgekehrten Schrägstrich (\) in den Wert einschließen, tritt ein Fehler auf.

Das VisualGroup-Attribut ist ungültig, wenn das Manifest nur eine App deklariert.

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

Für die Bilder Square150x150Logo und Square44x44Logo können Sie Bilder unterschiedlicher 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 in den Themen Globalisierung und Lokalisierung des Paketmanifests .

Die Größenanforderungen von zwei Typen 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 (375x775)

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
lavendelBlush
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
blassgrün
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

Im folgenden Beispiel wird ein Ordner namens App1 in der Liste "Alle Apps" erstellt und die Kachel für App1 in diesem Ordner gespeichert.

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"  
    IgnorableNamespaces="... desktop">
    <Applications>
        <Application>
            <uap3:VisualElements
                DisplayName="App1" 
                Square150x150Logo="images/150x150.png" 
                Square44x44Logo="images/44x44.png" 
                Description="App1" 
                BackgroundColor="#777777" 
                AppListEntry="default" 
                VisualGroup="App1">  
                <uap:SplashScreen
                    BackgroundColor="#777777" 
                    Image="images/splash.png"/>  
           </uap3:VisualElements>  
        </Application>
    </Applications>
</Package>

Anforderungen

Element Wert
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/3
Minimum OS Version Windows 10 Version 1607 (Build 14393)