VisualElements (schéma des extensions de fonctionnalité pour Windows 8.1)

Article
07/20/2023

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 Square150x150Logo = 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.
                Square30x30Logo   = 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?
  & ApplicationView?
  )

</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
Square150x150Logo	Image 150 x 150 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
Square30x30Logo	Image 30x30 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

Éléments enfants

Élément enfant	Description
ApplicationView	Décrit comment l’application est affichée à l’écran.
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 aspects visuels des applications, consultez VisualElements.

Le manifeste effectue ces vérifications sémantiques pour VisualElements, qui ne sont pas appliquées dans le schéma.

Si DefaultTile\Square310x310Logo est spécifié, DefaultTile\Wide310x150Logo doit également être spécifié.
Si DefaultTile\DefaultSize ou ShowNameOnTiles spécifient une certaine valeur de taille d’image, cette taille d’image doit avoir été déclarée dans le manifeste.
Si LockScreen\Notification a la valeur badgeAndTileText, DefaultTile\Wide310x150Logo doit être spécifié.

Les images Square150x150Logo et Square30x30Logo peuvent être fournies en tant que chemin d’accès direct à un fichier image ou en tant que ressource. À l’aide d’une référence de ressource, vous pouvez fournir des images localisées qui correspondent aux différentes langues de l’interface utilisateur. Pour plus d’informations, consultez la rubrique Globalization .

Spécifications

	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/2013/manifest`

Partager via