Image.Stretch Propriété

Définition

Espace de noms:

Windows.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 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 l’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 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 s’il existe un conteneur de disposition qui peut l’étirer dans le cas contraire. Pour plus d’informations sur le dimensionnement de l’image, consultez Remarques dans 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 s’affiche bien lorsque Windows la met à l’échelle en raison de la mise à l’échelle et de la résolution de l’appareil. 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 de nommage et plus d’informations, consultez Charger des images et des ressources adaptées à l’échelle.

Pour plus d’informations sur la conception de la mise à l’échelle, consultez Présentation de la conception d’applications Windows.

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 que les décisions de disposition impliquées par la valeur None soient appliquées.