Image.Stretch Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit une valeur qui décrit comment une image doit être étirée pour remplir le rectangle de destination.

public:
 property Stretch Stretch { Stretch get(); void set(Stretch value); };

Stretch Stretch();

void Stretch(Stretch value);

public Stretch Stretch { get; set; }

var stretch = image.stretch;
image.stretch = stretch;

Public Property Stretch As Stretch

<Image Stretch="stretchValue"/>

Valeur de propriété

Stretch

Valeur de l’énumération Stretch qui spécifie le mode de rendu de l’image source, si la hauteur et/ou la largeur de l’image ne sont pas spécifiées explicitement. La valeur par défaut est Uniform.

Remarques

La valeur de la propriété Stretch n’est pertinente que si le instance Image n’utilise pas déjà des valeurs définies explicitement pour la propriété Height et/ou Width, et si l’instance Image se trouve à l’intérieur d’un conteneur qui peut étirer l’image pour remplir de l’espace disponible dans la disposition. Si vous définissez la valeur de la propriété Stretch sur None, l’image conserve toujours sa taille naturelle, même si un conteneur de disposition peut l’étirer dans le cas contraire. Pour plus d’informations sur le dimensionnement de l’image, consultez Remarques dans l’image.

Sources d’images et mise à l’échelle

Vous devez créer vos sources d’images à plusieurs tailles recommandées, pour vous assurer que votre application est parfaite lorsque Windows la met à l’échelle en raison de la mise à l’échelle et de la résolution des appareils. Il s’agit souvent d’un meilleur moyen de gérer le redimensionnement de l’image plutôt que d’appliquer une valeur Stretch non définie par défaut. Lorsque vous spécifiez une propriété Source pour un objet Image, vous pouvez utiliser une convention d’affectation de noms qui référencera automatiquement la ressource appropriée pour la mise à l’échelle actuelle. Pour plus d’informations sur la convention d’affectation de noms et plus d’informations, consultez Charger des images et des ressources adaptées à la mise à l’échelle.

Notes

La valeur Stretch None ne fonctionne pas pour les ressources d’image destinées à prendre en charge la mise à l’échelle. La mise à l’échelle est détectée et la ressource mise à l’échelle appropriée est chargée avant l’application des décisions de disposition impliquées par la valeur None .