Image.Stretch property

Gets or sets a value that describes how an Image should be stretched to fill the destination rectangle.

Syntax

public Stretch Stretch { get; set; }

<Image Stretch="stretchValue"/>

XAML Values

stretchValue

A named constant of the Stretch enumeration, such as Uniform.

Property value

Type: Stretch

A value of the Stretch enumeration that specifies how the source image is applied if the Height and Width of the Image are specified and are different than the source image's height and width. The default value is Uniform.

Image sources and scaling

You should create your image sources at several recommended sizes, to ensure that your app looks great when Windows 8 scales it. This is often a better way to go than applying a nondefault Stretch. When specifying a Source for an Image, you can use a naming convention that will automatically reference the correct resource for the current scaling. For specifics of the naming convention and more info, see Quickstart: Using file or image resources.

For more info on how to design for scaling, see Guidelines for scaling to pixel density.

Requirements

See also

Image

Build date: 3/12/2013