BackgroundImage

Note

Créez-vous des scénarios Copilot, Teams ou Outlook optimisés par des cartes adaptatives ? Visitez le Hub de documentation sur la carte adaptative, le nouveau magasin unique pour tous vos besoins en carte adaptative ! Il dispose de toutes les ressources que vous recherchez, y compris la documentation complète pour de nombreuses nouvelles fonctionnalités, telles que la disposition réactive, l’icône, le badge, le carrouel, les graphiques, etc.

Remarque importante sur l’accessibilité : Dans la version 1.3 du schéma, nous avons introduit une propriété d’étiquette sur les entrées pour améliorer l’accessibilité. Si l’application hôte que vous ciblez prend en charge la version 1.3, vous devez utiliser l’étiquette au lieu d’un TextBlock comme indiqué dans certains exemples ci-dessous. Une fois que la plupart des applications hôtes ont été mises à jour vers la dernière version, nous allons mettre à jour les exemples en conséquence.

BackgroundImage

Spécifie une image d’arrière-plan. Les formats acceptables sont PNG, JPEG et GIF.

Introduit dans la version 1.2

Propriétés BackgroundImage

Propriété	Type	Obligatoire	Descriptif	Version
url	uri	Oui	URL (ou URL de données) de l’image. Les formats acceptables sont PNG, JPEG et GIF.	1.2
fillMode	ImageFillMode	Non	Décrit comment l’image doit remplir la zone.	1.2
horizontalAlignment	HorizontalAlignment	Non	Décrit comment l’image doit être alignée si elle doit être rognée ou si vous utilisez le mode de remplissage répété.	1.2
verticalAlignment	VerticalAlignment	Non	Décrit comment l’image doit être alignée si elle doit être rognée ou si vous utilisez le mode de remplissage répété.	1.2

---

Propriétés

URL

URL (ou URL de données) de l’image. Les formats acceptables sont PNG, JPEG et GIF.

• Type : uri
• Obligatoire : Oui

mode de remplissage

Décrit comment l’image doit remplir la zone.

• Type : ImageFillMode
• Obligatoire : Non
• Valeurs autorisées :
  • "cover": l’image d’arrière-plan couvre toute la largeur du conteneur. Son format d'image est conservé. Le contenu peut être clippé si le rapport d’aspect de l’image ne correspond pas au rapport d’aspect du conteneur. verticalAlignment est respecté (horizontalAlignment est sans signification, car il est étiré de largeur). Il s’agit du mode par défaut et est l’équivalent du modèle actuel.
  • "repeatHorizontally": L'image d'arrière-plan n'est pas agrandie. Il est répété dans l’axe x autant de fois que nécessaire pour couvrir la largeur du conteneur. verticalAlignment est honoré (la valeur par défaut est supérieure), horizontalAlignment est ignoré.
  • "repeatVertically": L'image de fond n'est pas étirée. Il est répété dans l’axe y autant de fois que nécessaire pour couvrir la hauteur du conteneur. verticalAlignment est ignoré, horizontalAlignment est respecté (la valeur par défaut est gauche).
  • "repeat": l’image d’arrière-plan n’est pas agrandie. Il est répété en premier dans l’axe x, puis dans l’axe y autant de fois que nécessaire pour couvrir l’intégralité du conteneur. HorizontalAlignment et verticalAlignment sont respectés (les valeurs par défaut sont gauches et supérieures).

horizontalAlignment

Décrit comment l’image doit être alignée si elle doit être rognée ou si vous utilisez le mode de remplissage répété.

• Type : HorizontalAlignment
• Obligatoire : Non
• Valeurs autorisées :
  • "left"
  • "center"
  • "right"

verticalAlignment

Décrit comment l’image doit être alignée si elle doit être rognée ou si vous utilisez le mode de remplissage répété.

• Type : VerticalAlignment
• Obligatoire : Non
• Valeurs autorisées :
  • "top"
  • "center"
  • "bottom"