uap3 :VisualElements (Windows 10)

Article
05/03/2024

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

Hiérarchie d’éléments

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

Clé :

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

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
DisplayName	Nom convivial de l’application qui peut être affiché aux utilisateurs. Cette chaîne est localisable ; Pour plus d’informations, consultez Remarques.	Chaîne dont la valeur est 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 d’application.	Nombre hexadécimal de trois octets précédé de `#` ou d’une couleur nommée. Pour obtenir la liste des couleurs nommées, consultez Remarques .	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 avec une valeur comprise entre 1 et 256 caractères qui se termine par `.jpg`, `.png`ou `.jpeg` qui ne peut pas contenir les caractères suivants : `<`, `>`, `:"`, `\|`, `?`, ou `*`. 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 é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 avec une valeur comprise entre 1 et 256 caractères qui se termine par `.jpg`, `.png`ou `.jpeg` qui ne peut pas contenir les caractères suivants : `<`, `>`, `:"`, `\|`, `?`, ou `*`. 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.	Chaîne facultative qui peut avoir l’une des valeurs suivantes : par défaut ou aucune.	No
VisualGroup	Nom d’un dossier à créer dans la liste Toutes les applications, dans laquelle la vignette de l’application doit être stockée.	Chaîne dont la valeur est comprise entre 1 et 256 caractères et qui ne contient pas de barres obliques inverses (`\`) ou d’espaces.	Non

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	Définit la 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 revient à cette valeur par défaut.
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.
uap:InitialRotationPreference	Décrit les orientations dans lesquelles l’application préférerait être affichée pour une expérience utilisateur optimale.

É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

Vous ne pouvez pas utiliser l’attribut VisualGroup pour créer une structure de dossiers imbriqués. Si vous incluez une barre oblique inverse (\) dans la valeur, une erreur se produit.

L’attribut VisualGroup n’est pas valide si le manifeste déclare une seule application.

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 la résolution de l’appareil et de l’é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 les rubriques Globalisation et localisation du manifeste de package .

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 (375x375)
`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
pêchePuff
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 crée un dossier nommé App1 dans la liste Toutes les applications et stocke la vignette app1 dans ce dossier.

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

Configuration requise

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

Partager via

uap3 :VisualElements (Windows 10)

Hiérarchie d’éléments

Syntax

Clé :

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Remarques

Exemples

Configuration requise

Commentaires

Ressources supplémentaires

Partager via

uap3 :VisualElements (Windows 10)

Hiérarchie d’éléments

Syntax

Clé :

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Remarques

Exemples

Rubriques connexes

Configuration requise

Commentaires

Ressources supplémentaires