VisualElements (schéma des extensions pour Windows 8.1)
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 de l’écran de verrouillage.
Hiérarchie d’éléments
<VisualElements>
Syntaxe
<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.
ForegroundText = "light" | "dark"
BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
ToastCapable? = boolean
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. >
<!-- Child elements -->
( DefaultTile?
& LockScreen?
& SplashScreen
& InitialRotationPreference?
)
</VisualElements>
Clé
? facultatif (zéro ou un)
& connecteur entrelacé (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 Notes pour les noms de couleurs. Notez que la couleur d’arrière-plan spécifiée ici s’applique également aux éléments suivants :
s’applique à Windows Phone : le choix de l’option « transparent » entraîne l’utilisation de la couleur d’accentuation système. |
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 peut être localisée ; Pour plus d’informations, consultez la section Notes. |
Chaîne comportant entre 1 et 2048 caractères qui ne peuvent pas contenir de caractères tels que des tabulations, des retours chariot et des sauts de ligne. | Oui | |
| DisplayName | Nom convivial de l’application qui peut être affiché aux utilisateurs. Cette chaîne peut être localisée ; Pour plus d’informations, consultez la section Notes. il existe deux mots réservés explicitement qui ne peuvent 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 de longueur comprise entre 1 et 256 caractères. Cette chaîne est localisable. | Oui | |
| ForegroundText | Spécifie la couleur de premier plan de la vignette de l’application. s’applique à Windows Phone : le choix de l’option « transparent » entraîne l’utilisation de la couleur d’accentuation système. |
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 spécification de l’image dans cet attribut, consultez la section Notes. |
Chaîne contenant entre 1 et 256 caractères qui se terminent par « .jpg », « .png » ou « . jpeg » qui ne peuvent 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ère. En outre, la chaîne peut contenir/ou \, mais pas les deux. | Oui | |
| SmallLogo | Petite image affichée dans l’angle de la vignette pour identifier l’application. Pour plus d’informations sur la façon de spécifier l’image dans cet attribut, consultez la section Notes. s’applique à Windows Phone : Windows Phone ne prend pas en charge le petit logo sur la vignette. Il est utilisé uniquement dans la liste des applications. |
Chaîne contenant entre 1 et 256 caractères qui se terminent par « .jpg », « .png » ou « . jpeg » qui ne peuvent 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ère. 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 s’affichent, ne spécifiez pas de valeur pour cet attribut. Notez que les applications ne doivent pas prendre de décision quant à l’envoi de notifications Toast sur la base de cette valeur. |
boolean | Non |
Éléments enfants
| Élément enfant | Description |
|---|---|
| DefaultTile | Mosaïque 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 d’avoir reçu des notifications de mise à jour. Quand une vignette n’a pas de notifications à afficher, la vignette revient à la valeur par défaut. |
| InitialRotationPreference | Décrit les orientations dans lesquelles l’application préfère être affichée pour une expérience utilisateur optimale. Sur un appareil qui peut être pivoté, par exemple 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 des orientations paysage et LandscapeFlipped, et que l’appareil passe à l’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 l’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 respectée. Ces choix d’orientation s’appliquent à la fois à [é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 au moment de l’exécution via le [AutoRotationPreferences] (/UWP/API/Windows. Graphics. Display. DisplayInformation). |
| 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é par l’application lors du lancement. |
Éléments parents
Cet élément (document) le plus à l’extérieur ne peut pas être contenu dans d’autres éléments.
Notes
Pour plus d’informations sur les spécifications de dimension en mosaïque, consultez tailles de mosaïques.
Les images logo et SmallLogo peuvent être fournies en tant que chemin d’accès direct à 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 Globalization .
Applications/applications/extensions/extension/FileTypeAssociation/logo applications/application/extensions/extension/protocole/logo
Les exigences de taille de deux types d’images de logo sont indiquées ici :
Taille de l’image mise à l’échelle des attributs d’image en pixels Applications\Application\VisualElements\ @Logo 100 150 x 150 140 210x210 180 270x270 Applications\Application\VisualElements\ @SmallLogo 100 30x30 140 42x42 180 54x54
Les noms de couleur d’arrière-plan pris en charge sont les suivants :
| 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 | Valeur CornflowerBlue |
| Violet bourbon | Rouge cramoisi | Cyan | darkBlue | darkCyan | darkGoldenrod |
| Gris foncé | 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é |
| hotPink | indianRed | Indigo | Blanc ivoire | Vert kaki | Bleu lavande |
| lavenderBlush | 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 | Papaye | peachPuff |
| Brun Pérou | pink | Violet prune | powderBlue | purple | rouge |
| rosyBrown | royalBlue | saddleBrown | Saumon | sandyBrown | Vert marin |
| seaShell | Brun terre de Sienne | Gris argent | skyBlue | slateBlue | Ardoise |
| Blanc neige | springGreen | steelBlue | tan | Bleu sarcelle | Violet chardon |
| Rouge tomate | transparent | Turquoise | Violet | Jaune blé | white |
| Valeur Blanc fumée | 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