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
<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) |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour