Image.Stretch Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece un valor que describe cómo se debe estirar una imagen para rellenar el rectángulo de destino.

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"/>

Valor de propiedad

Stretch

Valor de la enumeración Stretch que especifica cómo se representa la imagen de origen, si no se especifica explícitamente el alto o el ancho de la imagen . El valor predeterminado es Uniform.

Comentarios

El valor de la propiedad Stretch solo es relevante si la instancia de Image aún no usa valores establecidos explícitamente para la propiedad Height o Width , y si la instancia de Image está dentro de un contenedor que puede extender la imagen para rellenar algún espacio disponible en el diseño. Si establece el valor de la propiedad Stretch en None, la imagen siempre conserva su tamaño natural, incluso si hay un contenedor de diseño que podría estirarlo de otro modo. Para obtener más información sobre el ajuste de tamaño de imagen, consulta Comentarios en imagen.

Orígenes y escala de las imágenes

Debes crear orígenes de imágenes en varios tamaños recomendados, para asegurarte de que tu aplicación tenga un aspecto excelente cuando Windows lo escala debido al escalado de dispositivos y la resolución. A menudo, esta es una mejor manera de controlar el cambio de tamaño de la imagen en lugar de aplicar un valor stretch no predeterminado. Cuando se especifica una propiedad Source para un elemento Image, puedes usar una convención de nomenclatura que haga referencia automáticamente al recurso correcto para la escala actual. Para obtener información específica sobre la convención de nomenclatura y más información, consulte Carga de imágenes y recursos adaptados para la escala.

Para obtener más información sobre cómo diseñar el escalado, consulta Introducción al diseño de aplicaciones de Windows.

Nota

Un valor Stretch de None no funciona para los recursos de imagen que están diseñados para admitir el escalado. Se detectará el escalado y se cargará el recurso escalado adecuado antes de que se apliquen las decisiones de diseño implícitas por el valor None .