UAP: visualelements (Windows 10)uap:VisualElements (Windows 10)

Beschreibt die visuellen Aspekte der APP: die Standard Kachel, Logo Bilder, Text-und Hintergrundfarben, anfängliche Bildschirm Ausrichtung, Begrüßungsbildschirm und Kachel Darstellung des Sperr Bildschirms.Describes the visual aspects of the app: its default tile, logo images, text and background colors, initial screen orientation, splash screen, and lock screen tile appearance.

ElementhierarchieElement hierarchy

<Paketen>
<Package>
<Bereich>
<Applications>
<Asyl>
<Application>
<uap:VisualElements><uap:VisualElements>

SyntaxSyntax

<VisualElements DisplayName       = A string between 1 and 256 characters in length. This string is localizable. 
                    Description       = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
                    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 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 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?     = "default" | "none" >

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

</uap:VisualElements>

SchlüsselKey

?  Optionaler (null oder ein) &    Interleave-Connector (kann in beliebiger Reihenfolge auftreten)?   optional (zero or one) &   interleave connector (may occur in any order)

Attribute und ElementeAttributes and Elements

AttributeAttributes

attributeAttribute BESCHREIBUNGDescription DatentypData type ErforderlichRequired StandardwertDefault value
ApplistentryAppListEntry

Der Eintrag in der Liste "alle apps".The entry in the All Apps List.

Dieses Attribut kann einen der folgenden Werte aufweisen:This attribute can have one of the following values:

  • defaultdefault
  • nonenone
NeinNo defaultdefault
BackgroundColorBackgroundColor

Gibt die Hintergrundfarbe der APP-Kachel an.Specifies the background color of the app tile. Farbnamen finden Sie im Abschnitt "Hinweise".See the Remarks section for color names. Beachten Sie, dass die hier angegebene Hintergrundfarbe auch für diese Elemente gilt:Note that the background color specified here also applies to these items:

  • Die Schaltflächen Farbe in allen APP-eigenen Dialogfeldern.The button color in any app-owned dialog boxes
  • Die APP-Beschreibungsseite im StoreThe App Description page in the Store
Eine 3-Byte-hexadezimal Zahl, der " # " oder eine benannte Farbe vorangestellt ist.A three-byte hexadecimal number preceded by "#" or a named color. Eine Liste benannter Farben finden Sie unter "Hinweise".See Remarks for a list of named colors. JaYes
BeschreibungDescription

Die Beschreibung der app.The description of the app. Diese Zeichenfolge ist lokalisierbar. Weitere Informationen finden Sie in den hinweisen.This string is localizable; see Remarks for details.

Eine Zeichenfolge mit einer Länge von 1 bis 2048 Zeichen, die keine Zeichen wie Registerkarten, Wagen Rückläufe und Zeilen Feeds enthalten darf.A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds. JaYes
DisplayNameDisplayName

Ein Anzeige Name für die APP, der Benutzern angezeigt werden kann.A friendly name for the app that can be displayed to users. Diese Zeichenfolge ist lokalisierbar. Weitere Informationen finden Sie in den hinweisen.This string is localizable; see Remarks for details.

Es gibt zwei explizit reservierte Wörter, die möglicherweise nicht als Display Name für Apps verwendet werden, die in den Store hochgeladen werden: " nouientrypoints " und " nouientrypoints-DesignMode " .There are two explicitly reserved words that may not be used as the DisplayName for apps uploaded to the Store: "NoUIEntryPoints" and "NoUIEntryPoints-DesignMode". Diese Bezeichner sind für Entwicklungstools und Testsammlungen reserviert.These identifiers are reserved for use by development tools and test suites.

Eine Zeichenfolge zwischen 1 und 256 Zeichen.A string between 1 and 256 characters in length. Diese Zeichenfolge kann lokalisiert werden.This string is localizable. JaYes
Square150x150LogoSquare150x150Logo

Ein Bild, das als Start Bildschirm mittlere Kachel der APP und in der Aufgaben Umschaltung verwendet wird.An image used as the app's Start Screen medium tile, and on the Task Switcher. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter "Hinweise".For more info about how to specify the image in this attribute, see Remarks.

Eine Zeichenfolge mit einer Länge von 1 bis 256 Zeichen, die mit " JPG " , " PNG " oder JPEG endet und " " folgende Zeichen nicht enthalten kann: < , > ,:, " , |,? oder \*.A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or \*. In dieser Zeichenfolge dürfen die Zeichen/und \ weder das erste noch das letzte Zeichen sein.In this string, the / and \ characters can't be the first or last characters. Außerdem kann die Zeichenfolge/oder \, aber nicht beides enthalten.Also, the string can contain / or \ but not both. JaYes
Square44x44LogoSquare44x44Logo

Ein Bild, das als Start Bildschirm-Kachel der APP und in der Liste alle apps verwendet wird.An image used as the app's Start Screen small tile, and on the All Apps List. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter "Hinweise".For more info about how to specify the image in this attribute, see Remarks.

Eine Zeichenfolge mit einer Länge von 1 bis 256 Zeichen, die mit " JPG " , " PNG " oder JPEG endet und " " folgende Zeichen nicht enthalten kann: < , > ,:, " , |,? oder \*.A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or \*. In dieser Zeichenfolge dürfen die Zeichen/und \ weder das erste noch das letzte Zeichen sein.In this string, the / and \ characters can't be the first or last characters. Außerdem kann die Zeichenfolge/oder \, aber nicht beides enthalten.Also, the string can contain / or \ but not both. JaYes

 

Untergeordnete ElementeChild Elements

Untergeordnetes ElementChild Element BESCHREIBUNGDescription
UAP: defaulttile uap:DefaultTile

Die Standard Kachel, die die APP auf dem Start Bildschirm darstellt.The default tile that represents the app on the Start screen. Diese Kachel wird angezeigt, wenn die APP zum ersten Mal installiert wird, bevor Update Benachrichtigungen empfangen wurden.This tile is displayed when the app is first installed, before it has received any update notifications. Wenn eine Kachel keine anzuzeigenden Benachrichtigungen enthält, wird diese Standardeinstellung wieder hergestellt.When a tile has no notifications to show, the tile reverts to this default.

UAP: initialrotationpreference uap:InitialRotationPreference

Beschreibt die Ausrichtungen, in denen die APP bevorzugt werden soll, um die beste Benutzer Leistung zu erzielen.Describes the orientations in which the app would prefer to be shown for the best user experience. Auf einem Gerät, das rotiert werden kann, z. b. ein Tablet, wird die APP nicht neu gezeichnet, weil Sie nicht an dieser Stelle angegeben sind.On a device that can be rotated, such as a tablet, the app will not be redrawn for orientations that are not specified here. Wenn die APP beispielsweise nur Querformat-und Querformat Ausrichtung angibt und das Gerät in eine Hochformat Ausrichtung gedreht wird, wird die APP nicht rotiert.For instance, if the app specifies only Landscape and LandscapeFlipped orientations, and the device is rotated to a Portrait orientation, the app will not rotate.

Beachten Sie, dass auf Geräten, die nicht rotiert werden können, möglicherweise eine app in der Standardausrichtung des Geräts angezeigt wird und die bevorzugte Ausrichtung der APP ignoriert wird.Note that on devices that can't be rotated, an app might be shown in that device's default orientation and the app's preferred orientation will be ignored. Auf einem Gerät, bei dem eine Rotations Sperre aktiviert ist, wird die bevorzugte Rotation Ihrer APP jedoch weiterhin berücksichtigt.However, on a device with a rotation lock activated, your app's preferred rotation will still be honored.

Diese Ausrichtungs Einstellungsoptionen gelten für den Begrüßungs Bildschirm und die App-Benutzeroberfläche, wenn eine neue Sitzung für Ihre APP gestartet wird.These orientation preference choices apply to both the splash screen and the app UI when a new session is launched for your app. Die Einstellungen können während der Laufzeit über die autorotationpreferences -Eigenschaft geändert werden.The preferences can be changed during run time through the AutoRotationPreferences property.

UAP: Sperrbildschirm uap:LockScreen

Definiert das Badge und die Benachrichtigungen, die die APP auf dem Sperrbildschirm darstellen, der angezeigt wird, wenn das System gesperrt ist.Defines the badge and notifications that represent the app on the lock screen, which is shown when the system is locked.

UAP: SplashScreen uap:SplashScreen

Definiert die Darstellung des Begrüßungs Bildschirms, der während des Starts von der App angezeigt wird.Defines the appearance of the splash screen, which is displayed by the app during launch.

 

Übergeordnete ElementeParent Elements

Übergeordnetes ElementParent Element BESCHREIBUNGDescription
Asyl Application

Stellt eine APP dar, die einen Teil oder die gesamte Funktionalität des Pakets umfasst.Represents an app that comprises part of or all of the functionality delivered in the package.

 

BemerkungenRemarks

Weitere Informationen zu den Kachel Dimensions Anforderungen finden Sie unter Kachel Größen.For more info on tile dimension requirements, see Tile sizes.

Bei den Images Square150x150Logo und Square44x44Logo können Sie Bilder unterschiedlicher Skalen bereitstellen, damit Windows die beste Größe für das Gerät und die Bildschirmauflösung auswählen kann.For the Square150x150Logo and Square44x44Logo images, you can supply images of different scales so that Windows can choose the best size for the device and screen resolution. Sie können auch Bilder mit hohem Kontrast für die Barrierefreiheit sowie lokalisierte Bilder für verschiedene Benutzeroberflächensprachen bereitstellen.You can also supply high contrast images for accessibility and localized images to match different UI languages. Mit dieser Funktion können Sie auch die Attribute Display Name und Description lokalisieren.This feature also allows you to localize the DisplayName and Description attributes. Weitere Informationen finden Sie im Thema zur Globalisierung .For more info, see the Globalization topic.

Anwendungen/Anwendung/Erweiterungen/Erweiterung/filetypeassociation/Logo Anwendungen/Anwendung/Erweiterungen/Erweiterung/Protokoll/LogoApplications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

Die Größenanforderungen von zwei Typen von Logo Bildern werden hier angezeigt:Size requirements of two types of logo images are shown here:

Image Attribute Scale Image Size in Pixel Applications/Application/VisualElements/@Square150x150Logo 100 150x150 250 375x375 Applications/Application/VisualElements/@Square44x44Logo 100 quadratisches 44x44 250 110x110 Applications/Application/VisualElements/@Tall150x310Logo 100 150x310 250 375x775Image attribute Scale Image size in pixels 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 Hintergrund Farbnamen:These are the supported background color names:

aliceBluealiceBlue antiqueweißantiqueWhite aquaaqua aquamarineaquamarine azureazure beigebeige
bisquebisque blackblack BlanchedAlmondblanchedAlmond blueblue blueviolettblueViolet brownbrown
BurlyWoodburlyWood CadetBluecadetBlue chartreusechartreuse chocolatechocolate coralcoral CornflowerBlue stehtcornflowerBlue
cornsilkcornsilk crimsoncrimson cyancyan dunkelblaudarkBlue dunkel ZyandarkCyan darkgoldenroddarkGoldenrod
darkGraydarkGray dunkelgründarkGreen DarkKhakidarkKhaki darkmagentadarkMagenta darkolivegründarkOliveGreen DarkOrangedarkOrange
DarkOrchiddarkOrchid dunkel rotdarkRed darklachsdarkSalmon Dark-agreendarkSeaGreen DarkSlateBluedarkSlateBlue DarkSlateGraydarkSlateGray
dunkel türkisdarkTurquoise dunkelviolettdarkViolet deeppinkdeepPink Deep skybluedeepSkyBlue DimGraydimGray DodgerBluedodgerBlue
firebrickfirebrick FloralWhitefloralWhite forestgrünforestGreen fuchsiafuchsia gainsborogainsboro GhostWhiteghostWhite
goldgold goldenrodgoldenrod graygray greengreen greengelbgreenYellow honeydewhoneydew
hotrosahotPink nicht markiertindianRed indigoindigo ivoryivory khakikhaki lavenderlavender
lavenderblushlavenderBlush gesetzngrünlawnGreen limonchiffonlemonChiffon lightBluelightBlue LightCorallightCoral LightCyanlightCyan
LightGoldenrodYellowlightGoldenrodYellow hellgrünlightGreen lightGraylightGray HellrosalightPink LightSalmonlightSalmon lighteinagreenlightSeaGreen
LightSkyBluelightSkyBlue lightürlategraylightSlateGray LightSteelBluelightSteelBlue LightYellowlightYellow limelime limegrünlimeGreen
linenlinen magentamagenta maroonmaroon MediumAquamarinemediumAquamarine MediumBluemediumBlue medienorchideemediumOrchid
mediumschlagmediumPurple mediumschlag agreenmediumSeaGreen MediumSlateBluemediumSlateBlue mediumspringgrünmediumSpringGreen mediumschlagmediumTurquoise mediin violetredmediumVioletRed
Mittel Nacht blaumidnightBlue MintCreammintCream MistyRose ausmistyRose moccasinmoccasin NavajoWhitenavajoWhite navynavy
OldLaceoldLace oliveolive OliveDraboliveDrab orangeorange OrangeorangeRed orchidorchid
palegoldenrodpaleGoldenrod blassgrünpaleGreen palettentürkispaleTurquoise palävioletredpaleVioletRed PapayaWhippapayaWhip Peer PuffpeachPuff
peruperu pinkpink plumplum PowderbluepowderBlue purplepurple Rotred
RosyBrownrosyBrown RoyalBlueroyalBlue SaddleBrownsaddleBrown salmonsalmon SandyBrownsandyBrown -agredeseaGreen
Saison hellseaShell siennasienna silversilver skyblueskyBlue SlateBlueslateBlue SlateGrayslateGray
snowsnow springgrünspringGreen StahlblausteelBlue tantan tealteal thistlethistle
tomatotomato transparenttransparent turquoiseturquoise violetviolet wheatwheat whitewhite
whitesmukewhiteSmoke yellowyellow GelbgrünyellowGreen

 

BeispieleExamples

Das folgende Beispiel stammt aus dem Paket Manifest eines SDK-Beispiels.The following example is taken from the package manifest of an SDK sample.

                   
<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 auchSee also

App-Screenshots und -BilderApp screenshots and images

Colors-KlasseColors class

Schnellstart: Erstellen einer Standard Kachel mit dem Visual Studio-Manifest-EditorQuickstart: Creating a default tile using the Visual Studio manifest editor

Requirements (Anforderungen)Requirements

NamespaceNamespace http://schemas.microsoft.com/appx/manifest/uap/windows10