uap :VisualElements (Windows 10)

Décrit les aspects visuels de l’application : vignette par défaut, images de logo, couleurs de texte et d’arrière-plan, orientation initiale de l’écran, écran de démarrage et apparence de la vignette de l’écran de verrouillage.

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

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

Clé :

? connecteur facultatif (zéro ou un) & entrelacement (peut se produire dans n’importe quel ordre)

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire	Valeur par défaut
DisplayName	Nom convivial de l’application qui peut être affichée aux utilisateurs. Cette chaîne est localisable ; Pour plus d’informations, consultez Remarques .	Chaîne avec une valeur comprise entre 1 et 256 caractères. Cette chaîne est localisable.	Oui
Description	Description de l’application. Cette chaîne est localisable ; Pour plus d’informations, consultez Remarques .	Chaîne comprise entre 1 et 2 048 caractères.	Yes
BackgroundColor	Spécifie la couleur d’arrière-plan de la vignette de l’application. Consultez la section Remarques pour connaître les noms de couleurs.		Yes
Square150x150Logo	Image utilisée comme vignette moyenne de l’écran d’accueil de l’application et sur le sélecteur de tâches. Pour plus d’informations sur la façon de spécifier l’image dans cet attribut, consultez Remarques.	Chaîne comprise entre 1 et 256 caractères qui se termine par , ou qui ne peut pas contenir ces caractères : <, >, :, |", , ?, ou *..jpeg.png.jpg Dans cette chaîne, les / caractères et \ ne peuvent pas être le premier ou le dernier caractères. En outre, la chaîne peut contenir / ou mais \ pas les deux.	Yes
Square44x44Logo	Image utilisée comme petite vignette de l’écran d’accueil de l’application et dans la liste Toutes les applications. Pour plus d’informations sur la façon de spécifier l’image dans cet attribut, consultez Remarques.	Chaîne comprise entre 1 et 256 caractères qui se termine par , ou qui ne peut pas contenir ces caractères : <, >, :, |", , ?, ou *..jpeg.png.jpg Dans cette chaîne, les / caractères et \ ne peuvent pas être le premier ou le dernier caractères. En outre, la chaîne peut contenir / ou mais \ pas les deux.	Yes
AppListEntry	Entrée dans la liste Toutes les applications. Sélectionnez aucun pour les points d’entrée qui n’ont pas besoin de vignettes de menu Démarrer.	Chaîne facultative qui peut avoir l’une des valeurs suivantes : « default » ou « none ».	No	default

Notes

La couleur d’arrière-plan spécifiée ici s’applique également à ces éléments :

• Couleur du bouton dans toutes les boîtes de dialogue appartenant à l’application
• Page Description de l’application dans le Windows Store

Éléments enfants

Élément enfant	Description
uap:DefaultTile	Vignette par défaut qui représente l’application sur l’écran d’accueil. Cette vignette s’affiche lorsque l’application est installée pour la première fois, avant qu’elle n’ait reçu des notifications de mise à jour. Lorsqu’une vignette n’a aucune notification à afficher, la vignette rétablit cette valeur par défaut.
uap:InitialRotationPreference	Décrit les orientations dans lesquelles l’application préférerait être affichée pour une expérience utilisateur optimale. Sur un appareil qui peut être pivoté, tel qu’une tablette, l’application ne sera pas redessinée pour les orientations qui ne sont pas spécifiées ici. Par instance, si l’application spécifie uniquement Landscape des orientations et LandscapeFlipped et que l’appareil est pivoté vers une Portrait orientation, l’application ne pivote pas.
uap:LockScreen	Définit le badge et les notifications qui représentent l’application sur l’écran de verrouillage, qui s’affiche lorsque le système est verrouillé.
uap:SplashScreen	Définit l’apparence de l’écran de démarrage, qui est affiché par l’application lors du lancement.

Notes

Sur les appareils qui ne peuvent pas faire l’objet d’une rotation, une application peut être affichée dans l’orientation par défaut de cet appareil et l’orientation par défaut de l’application est ignorée. Toutefois, sur un appareil avec un verrou de rotation activé, la rotation préférée de votre application sera toujours respectée.

Ces choix de préférence d’orientation s’appliquent à la fois à l’écran de démarrage et à l’interface utilisateur de l’application lorsqu’une nouvelle session est lancée pour votre application. Les préférences peuvent être modifiées pendant l’exécution via la propriété AutoRotationPreferences .

Éléments parents

Élément parent	Description
Application	Représente une application qui comprend une partie ou la totalité des fonctionnalités fournies dans le package.

Remarques

Pour plus d’informations sur les exigences de dimension de vignette, consultez Tailles des vignettes.

Pour les images Square150x150Logo et Square44x44Logo , vous pouvez fournir des images de différentes échelles afin que Windows puisse choisir la meilleure taille pour l’appareil et la résolution d’écran. Vous pouvez également fournir des images à contraste élevé pour l’accessibilité et des images localisées correspondant aux différentes langues d’interface utilisateur. Cette fonctionnalité vous permet également de localiser les attributs DisplayName et Description . Pour plus d’informations, consultez la rubrique Globalisation .

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

Les exigences de taille de deux types d’images de logo sont indiquées ici :

Attribut Image	Mise à l’échelle (taille de l’image en pixels)
Applications/Application/VisualElements/@Square150x150Logo	100 (150x150)
	250 (375 x 375)
Applications/Application/VisualElements/@Square44x44Logo	100 (44x44)
	250 (110x110)
Applications/Application/VisualElements/@Tall150x310Logo	100 (150x310)
	250 (375x775)

Voici les noms de couleurs d’arrière-plan pris en charge :

aliceBlue
antiqueWhite
Bleu vert
Vert eau marine
azure
Beige
Beige bisque
black
blanchedAlmond
blue
blueViolet
Marron
Burlywood
cadetBlue
Vert Chartreuse
Brun chocolat
Corail
fleur de maïsBlue
Violet bourbon
Rouge cramoisi
Cyan
Darkblue
darkCyan
darkGoldenrod

darkGray
darkGreen
darkKhaki
darkMagenta
darkOliveGreen
darkOrange
darkOrchid
darkRed
darkSalmon
darkSeaGreen
darkSlateBlue
darkSlateGray
darkTurquoise
darkViolet
deepPink
deepSkyBlue
dimGray
dodgerBlue
Rouge brique
floralWhite
forestGreen
Fuchsia
Gris Gainsboro
ghostWhite

Or
Jaune doré
Gris
green
greenYellow
Miellé
Rose vif
indianRed
Indigo
Blanc ivoire
Vert kaki
Bleu lavande
lavandeBlush
lawnGreen
lemonChiffon
Lightblue
lightCoral
lightCyan
lightGoldenrodYellow
lightGray
lightGreen
lightPink
lightSalmon
lightSeaGreen

lightSkyBlue
lightSlateGray
lightSteelBlue
lightYellow
lime
limeGreen
Blanc lin
Magenta
Bordeaux
mediumAquamarine
mediumBlue
mediumOrchid
mediumPurple
mediumSeaGreen
mediumSlateBlue
mediumSpringGreen
mediumTurquoise
mediumVioletRed
midnightBlue
mintCream
mistyRose
Beige mocassin
navajoWhite

Bleu marine
oldLace
Vert olive
oliveDrab
orange
orangeRed
Violet orchidée
paleGoldenrod
paleGreen
paleTurquoise
paleVioletRed
papayeWhip
peachPuff
Brun Pérou
pink
Violet prune
powderBlue
purple
rouge
rosyBrown
royalBlue
saddleBrown
Saumon

Sandybrown
seaGreen
Seashell
Brun terre de Sienne
Gris argent
skyBlue
slateBlue
slateGray
Blanc neige
springGreen
steelBlue
tan
Bleu sarcelle
Violet chardon
Rouge tomate
transparent
Turquoise
Violet
Jaune blé
white
Whitesmoke
yellow
yellowGreen

Exemples

L’exemple suivant est tiré du manifeste de package d’un exemple de SDK.

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

Voir aussi

• Images et captures d’écran de l’application
• Classe Colors
• Démarrage rapide : Création d’une vignette par défaut à l’aide de l’éditeur de manifeste Visual Studio

Configuration requise

Élément	Valeur
Espace de noms	http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version	Windows 10 version 1511 (build 10586)