Stretch Enumeration (System.Windows.Media)

Stretch Enumeration

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Stretch Enumeration

Describes how content is resized to fill its allocated space.

Namespace: System.Windows.Media
Assembly: PresentationCore (in PresentationCore.dll)

Syntax

Visual Basic (Declaration)

Public Enumeration Stretch

Visual Basic (Usage)

Dim instance As Stretch

public enum Stretch

Visual C++

public enum class Stretch

JScript

public enum Stretch

XAML Attribute Usage

<object property="enumerationMemberName" .../>

Members

	Member name	Description
	None	The content preserves its original size.
	Fill	The content is resized to fill the destination dimensions. The aspect ratio is not preserved.
	Uniform	The content is resized to fit in the destination dimensions while it preserves its native aspect ratio.
	UniformToFill	The content is resized to fill the destination dimensions while it preserves 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.

Remarks

The following illustration shows the different Stretch values.

Stretch values

Examples

The following example shows how to create an instance of a Viewbox and set the Stretch mode of its content by using code.

Visual Basic

' Create a ViewBox and add it to the Canvas
Dim myViewbox As New Viewbox()
myViewbox.StretchDirection = StretchDirection.Both
myViewbox.Stretch = Stretch.Fill
myViewbox.MaxWidth = 400
myViewbox.MaxHeight = 400

Visual C++

// Create a Viewbox and add it to the Canvas
myViewbox = gcnew Viewbox();
myViewbox->StretchDirection = StretchDirection::Both;
myViewbox->Stretch = Stretch::Fill;
myViewbox->MaxWidth = 400;
myViewbox->MaxHeight = 400;

// Create a Viewbox and add it to the Canvas
myViewbox = new Viewbox();
myViewbox.StretchDirection = StretchDirection.Both;
myViewbox.Stretch = Stretch.Fill;
myViewbox.MaxWidth = 400;
myViewbox.MaxHeight = 400;

Platforms

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.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

System.Windows.Media Namespace

Other Resources

Painting with Images, Drawings, and Visuals