This documentation is archived and is not being maintained.

Image.StretchDirection Property

Gets or sets a value that indicates how the image is scaled. This is a dependency property.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

'Declaration
Public Property StretchDirection As StretchDirection
'Usage
Dim instance As Image 
Dim value As StretchDirection 

value = instance.StretchDirection

instance.StretchDirection = value
<object StretchDirection="StretchDirection" .../>

Property Value

Type: System.Windows.Controls.StretchDirection
One of the StretchDirection values. The default is Both.

Identifier field

StretchDirectionProperty

Metadata properties set to true

AffectsMeasure

The following example demonstrates how to use this property.

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

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Show: