Image.Stretch Propriedade

Definição

Obtém ou define um valor que descreve como um Image deve ser esticado para preencher o retângulo de destino.

public:
 property System::Windows::Media::Stretch Stretch { System::Windows::Media::Stretch get(); void set(System::Windows::Media::Stretch value); };
public System.Windows.Media.Stretch Stretch { get; set; }
member this.Stretch : System.Windows.Media.Stretch with get, set
Public Property Stretch As Stretch

Valor de Propriedade

Um dos Stretch valores. A predefinição é Uniform.

Exemplos

O exemplo seguinte demonstra como usar esta propriedade.

Image myImage1 = new Image();

// Set the stretch property.
myImage1.Stretch = Stretch.Fill;

// Set the StretchDirection property.
myImage1.StretchDirection = StretchDirection.Both;

// Create source
BitmapImage myBitmapImage1 = new BitmapImage();

// BitmapImage.UriSource must be in a BeginInit/EndInit block
myBitmapImage1.BeginInit();
myBitmapImage1.UriSource = new Uri(@"C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Winter.jpg");
myBitmapImage1.EndInit();

//set image source
myImage1.Source = myBitmapImage1;
Dim myImage1 As New Image()

' Set the stretch property.
myImage1.Stretch = Stretch.Fill

' Set the StretchDirection property.
myImage1.StretchDirection = StretchDirection.Both

' Create source
Dim myBitmapImage1 As New BitmapImage()

' BitmapImage.UriSource must be in a BeginInit/EndInit block
myBitmapImage1.BeginInit()
myBitmapImage1.UriSource = New Uri("C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Winter.jpg")
myBitmapImage1.EndInit()

'set image source
myImage1.Source = myBitmapImage1

Observações

Um valor de Fill fará com que a sua imagem se estique para preencher completamente a área de saída. Quando a área de saída e a imagem têm proporções de aspeto diferentes, a imagem é distorcida por este alongamento. Para preservar Image a proporção de aspeto da imagem, defina esta propriedade para Uniform (por defeito) ou UniformToFill.

Informação de Propriedade de Dependência

Iteme Value
Campo identificador StretchProperty
Propriedades dos metadados definidas como true AffectsMeasure

Aplica-se a

Ver também