VisualElements (schéma de package pour Windows 8)
Décrit les aspects visuels de l’application UWP : sa vignette par défaut, les images de logo, le texte et les couleurs d’arrière-plan, l’orientation initiale de l’écran, l’écran de démarrage et l’apparence de la vignette d’écran de verrouillage.
Hiérarchie d’éléments
- <Paquet>
-
- <Applications>
-
- <Application>
- <VisualElements>
Syntax
<VisualElements DisplayName = A string between 1 and 256 characters in length.
Logo = 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.
SmallLogo = 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.
Description = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
ForegroundText = "light" | "dark"
BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
ToastCapable? = boolean >
<!-- Child elements -->
( DefaultTile?
& LockScreen?
& SplashScreen
& InitialRotationPreference?
)
</VisualElements>
Clé :
? facultatif (zéro ou un)
& connecteur interleave (peut se produire dans n’importe quel ordre)
Attributs et éléments
Attributs
| Attribut | Description | Type de données | Obligatoire | Valeur par défaut |
|---|---|---|---|---|
| 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. Notez que la couleur d’arrière-plan spécifiée ici s’applique également à ces éléments :
|
Nombre hexadécimal de trois octets précédé de « # » ou d’une couleur nommée. | Oui | |
| Description | Description de l’application. Cette chaîne est localisable ; consultez Remarques pour plus d’informations. |
Chaîne comprise entre 1 et 2048 caractères qui ne peuvent pas inclure de caractères tels que des onglets, des retours chariots et des flux de ligne. | Oui | |
| DisplayName | Nom convivial de l’application qui peut être affichée aux utilisateurs. Cette chaîne est localisable ; consultez Remarques pour plus d’informations. Il existe deux mots réservés explicitement qui peuvent ne pas être utilisés comme DisplayName pour les applications chargées dans le Microsoft Store : « NoUIEntryPoints » et « NoUIEntryPoints-DesignMode ». L’utilisation de ces identificateurs est réservée aux outils de développement et aux suites de tests. |
Chaîne comprise entre 1 et 256 caractères de longueur. | Oui | |
| ForegroundText | Spécifie la couleur de premier plan de la vignette de l’application.
|
Cet attribut peut avoir l’une des valeurs suivantes :
|
Oui | |
| Logo | Image utilisée comme vignette carrée de l’application. 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 « .jpg », « .png » ou « .jpeg » qui ne peut pas contenir ces caractères : <, , >:, %, « |, ? » ou *. Dans cette chaîne, les caractères / et \ ne peuvent pas être les premiers ou les derniers caractères. En outre, la chaîne peut contenir / ou \ mais pas les deux. | Oui | |
| SmallLogo | Une petite image affichée dans le coin de la vignette pour identifier l’application. 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 « .jpg », « .png » ou « .jpeg » qui ne peut pas contenir ces caractères : <, , >:, %, « |, ? » ou *. Dans cette chaîne, les caractères / et \ ne peuvent pas être les premiers ou les derniers caractères. En outre, la chaîne peut contenir / ou \ mais pas les deux. | Oui | |
| ToastCapable | La valeur true indique que l’application est autorisée à fournir des notifications toast. La valeur par défaut est false. Si vous ne souhaitez pas que les notifications toast apparaissent, ne spécifiez pas de valeur pour cet attribut. Notez que les applications ne doivent pas prendre de décisions sur l’envoi de notifications toast en fonction de cette valeur. |
boolean | Non |
Éléments enfants
| Élément enfant | Description |
|---|---|
| DefaultTile | Vignette par défaut qui représente l’application sur l’écran de démarrage. Cette vignette s’affiche lorsque l’application est installée pour la première fois, avant de recevoir des notifications de mise à jour. Lorsqu’une vignette n’a aucune notification à afficher, la vignette revient à cette valeur par défaut. |
| InitialRotationPreference | Décrit les orientations dans lesquelles l’application préférerait être affichée pour la meilleure expérience utilisateur. 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 exemple, si l’application spécifie uniquement les orientations Paysage et PaysageFlipped, et que l’appareil est pivoté vers une orientation Portrait, l’application ne pivote pas. Notez que sur les appareils qui ne peuvent pas être pivotés, une application peut être affichée dans l’orientation par défaut de cet appareil et l’orientation préférée de l’application sera ignorée. Toutefois, sur un appareil avec un verrou de rotation activé, la rotation préférée de votre application sera toujours honorée. Ces choix de préférence d’orientation s’appliquent à la fois à l’écran de démarrage (element-splashscreen.md) 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 [AutoRotationPreferences](/uwp/api/Windows. Propriété Graphics.Display.DisplayProperties). |
| 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é. |
| SplashScreen | Définit l’apparence de l’écran de démarrage, qui est affichée par l’application pendant le lancement. |
Éléments parents
| Élément parent | Description |
|---|---|
| Application | Représente une application qui comprend une partie ou l’ensemble des fonctionnalités fournies dans le package. |
Remarques
Pour plus d’informations sur les exigences en matière de dimension de vignette, consultez Tailles des vignettes.
Les images Logo et SmallLogo peuvent être fournies comme un chemin direct vers un fichier image ou en tant que ressource. En utilisant une référence à une ressource, vous pouvez fournir des images d’échelles différentes afin que Windows puisse choisir la taille la mieux adaptée à 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 affichées ici :
Taille de l’image d’échelle de l’attribut image en pixels Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x544
Voici les noms de couleurs d’arrière-plan pris en charge :
| Nom | Nom | Nom | Nom | Nom | Nom |
|---|---|---|---|---|---|
| aliceBlue | antiqueWhite | Bleu vert | Vert eau marine | azure | Beige |
| Beige bisque | black | blanchedAlmond | blue | blueViolet | Marron |
| Burlywood | cadetBlue | Vert Chartreuse | Brun chocolat | Corail | cornflowerBlue |
| 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 | lightGreen | lightGray | 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 | papayaWhip | 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 est extrait du manifeste de package d’un exemple de KIT DE développement logiciel (SDK).
<Applications>
<Application Id="App" StartPage="default.html">
<VisualElements
DisplayName="ApplicationDataSample"
Logo="images\squareTile-sdk.png"
SmallLogo="images\smallTile-sdk.png"
Description="Application data sample"
ForegroundText="dark"
BackgroundColor="#FFFFFF"
ToastCapable="false">
<DefaultTile ShowName="allLogos"/>
<SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>
</Application>
</Applications>
Voir aussi
Images et captures d’écran de l’application
Spécifications
| Valeur | |
|---|---|
| Espace de noms | http://schemas.microsoft.com/appx/2010/manifest |
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