Export (0) Print
Expand All

Viewbox.Stretch Property

Gets or sets the Stretch mode, which determines how content fits into the available space.

Namespace:  System.Windows.Controls
Assembly:  System.Windows (in System.Windows.dll)

'Declaration
Public Property Stretch As Stretch
<ViewBox Stretch = "stretchValue"/>

XAML Values

stretchValue

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

Property Value

Type: System.Windows.Media.Stretch
A Stretch mode, which determines how content fits in the available space. The default is Uniform.

If you set the Stretch property to None, the content preserves its original size.

Stretch = None

ViewBox Stretch None

If you set the Stretch property to Uniform, the image is resized to fit the Viewbox. The Viewbox takes as much space as needed to show the entire image, while preserving the aspect ratio.

Stretch = Uniform

ViewBox Stretch Uniform

If you set the Stretch property to UniformToFill, the image is resized to fill the destination dimensions, while preserving its native aspect ratio. If the aspect ratio of the destination rectangle differs from the source, the source content is clipped to fit in the destination dimensions.

Stretch = UniformToFill

ViewBox Stretch UniformToFill

If you set the Stretch property to Fill, the image fills the entire space, but does not preserve the aspect ratio.

Stretch = Fill

ViewBox Stretch Fill

The following example shows how you can set the Stretch properties in C# and Visual Basic. This example is a part of a larger example available in the Viewbox class overview.


'Setting the Stretch property to None
Private Sub stretchNone(ByVal sender As Object, ByVal e As RoutedEventArgs)
    vb1.Stretch = Stretch.None
    vb2.Stretch = Stretch.None
    vb3.Stretch = Stretch.None
    txt1.Text = "Stretch is now set to None."
End Sub

'Setting the Stretch property to Fill
Private Sub stretchFill(ByVal sender As Object, ByVal e As RoutedEventArgs)
    vb1.Stretch = Stretch.Fill
    vb2.Stretch = Stretch.Fill
    vb3.Stretch = Stretch.Fill
    txt1.Text = "Stretch is now set to Fill."
End Sub

'Setting the Stretch property to Uniform
Private Sub stretchUni(ByVal sender As Object, ByVal e As RoutedEventArgs)
    vb1.Stretch = Stretch.Uniform
    vb2.Stretch = Stretch.Uniform
    vb3.Stretch = Stretch.Uniform
    txt1.Text = "Stretch is now set to Uniform."
End Sub

'Setting the Stretch property to UniformToFill
Private Sub stretchUniFill(ByVal sender As Object, ByVal e As RoutedEventArgs)
    vb1.Stretch = Stretch.UniformToFill
    vb2.Stretch = Stretch.UniformToFill
    vb3.Stretch = Stretch.UniformToFill
    txt1.Text = "Stretch is now set to UniformToFill."
End Sub


Silverlight

Supported in: 5, 4

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

ADD
Show:
© 2014 Microsoft