MSDN Library

.NET Development

.NET Framework 4.5 RC

.NET Framework Class Library

System.Windows Namespaces

System.Windows.Media

AdornerHitTestResult Class

AlignmentX Enumeration

AlignmentY Enumeration

ArcSegment Class

BezierSegment Class

BitmapCache Class

BitmapCacheBrush Class

BitmapScalingMode Enumeration

Brush Class

BrushConverter Class

Brushes Class

BrushMappingMode Enumeration

CacheMode Class

CacheModeConverter Class

CachingHint Enumeration

CharacterMetrics Class

CharacterMetricsDictionary Class

ClearTypeHint Enumeration

Color Structure

ColorContext Class

ColorConverter Class

ColorInterpolationMode Enumeration

Colors Class

CombinedGeometry Class

CompositionTarget Class

ContainerVisual Class

DashStyle Class

DashStyles Class

DisableDpiAwarenessAttribute Class

DoubleCollection Class

DoubleCollection.Enumerator Structure

DoubleCollectionConverter Class

Drawing Class

DrawingBrush Class

DrawingCollection Class

DrawingCollection.Enumerator Structure

DrawingContext Class

DrawingGroup Class

DrawingImage Class

DrawingVisual Class

EdgeMode Enumeration

EllipseGeometry Class

ExceptionEventArgs Class

FamilyTypeface Class

FamilyTypefaceCollection Class

FillRule Enumeration

FontEmbeddingManager Class

FontEmbeddingRight Enumeration

FontFamily Class

FontFamilyConverter Class

FontFamilyMap Class

FontFamilyMapCollection Class

FontFamilyValueSerializer Class

Fonts Class

FormattedText Class

GeneralTransform Class

GeneralTransformCollection Class

GeneralTransformCollection.Enumerator Structure

GeneralTransformGroup Class

Geometry Class

GeometryCollection Class

GeometryCollection.Enumerator Structure

GeometryCombineMode Enumeration

GeometryConverter Class

GeometryDrawing Class

GeometryGroup Class

GeometryHitTestParameters Class

GeometryHitTestResult Class

GlyphRun Class

GlyphRunDrawing Class

GlyphTypeface Class

GradientBrush Class

GradientSpreadMethod Enumeration

GradientStop Class

GradientStopCollection Class

GradientStopCollection.Enumerator Structure

GuidelineSet Class

HitTestFilterBehavior Enumeration

HitTestFilterCallback Delegate

HitTestParameters Class

HitTestResult Class

HitTestResultBehavior Enumeration

HitTestResultCallback Delegate

HostVisual Class

ImageBrush Class

ImageDrawing Class

ImageMetadata Class

ImageSource Class

ImageSourceConverter Class

ImageSourceValueSerializer Class

Int32Collection Class

Int32Collection.Enumerator Structure

Int32CollectionConverter Class

IntersectionDetail Enumeration

InvalidWmpVersionException Class

LanguageSpecificStringDictionary Class

LinearGradientBrush Class

LineGeometry Class

LineSegment Class

Matrix Structure

MatrixConverter Class

MatrixTransform Class

MediaClock Class

MediaPlayer Class

MediaScriptCommandEventArgs Class

MediaTimeline Class

NumberCultureSource Enumeration

NumberSubstitution Class

NumberSubstitutionMethod Enumeration

PathFigure Class

PathFigureCollection Class

PathFigureCollection.Enumerator Structure

PathFigureCollectionConverter Class

PathGeometry Class

PathSegment Class

PathSegmentCollection Class

PathSegmentCollection.Enumerator Structure

Pen Class

PenLineCap Enumeration

PenLineJoin Enumeration

PixelFormat Structure

PixelFormatChannelMask Structure

PixelFormatConverter Class

PixelFormats Class

PointCollection Class

PointCollection.Enumerator Structure

PointCollectionConverter Class

PointHitTestParameters Class

PointHitTestResult Class

PolyBezierSegment Class

PolyLineSegment Class

PolyQuadraticBezierSegment Class

QuadraticBezierSegment Class

RadialGradientBrush Class

RectangleGeometry Class

RenderCapability Class

RenderingEventArgs Class

RenderOptions Class

RequestCachePolicyConverter Class

RotateTransform Class

ScaleTransform Class

SkewTransform Class

SolidColorBrush Class

StreamGeometry Class

StreamGeometryContext Class

Stretch Enumeration

StyleSimulations Enumeration

SweepDirection Enumeration

TextEffect Class

TextEffectCollection Class

TextEffectCollection.Enumerator Structure

TextFormattingMode Enumeration

TextHintingMode Enumeration

TextOptions Class

TextRenderingMode Enumeration

TileBrush Class

TileMode Enumeration

ToleranceType Enumeration

Transform Class

TransformCollection Class

TransformCollection.Enumerator Structure

TransformConverter Class

TransformGroup Class

TranslateTransform Class

Typeface Class

VectorCollection Class

VectorCollection.Enumerator Structure

VectorCollectionConverter Class

VideoDrawing Class

Visual Class

VisualBrush Class

VisualCollection Class

VisualCollection.Enumerator Structure

VisualTarget Class

VisualTreeHelper Class

This topic has not yet been rated - Rate this topic

Stretch Enumeration

.NET Framework 4.5

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Describes how content is resized to fill its allocated space.

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

Copy


public enum Stretch

XAML Attribute Usage

Copy

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

	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.

The following illustration shows the different Stretch values.

Stretch values

Different TileBrush Stretch settings

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

Copy



// 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;

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Reference

System.Windows.Media Namespace

Other Resources

Painting with Images, Drawings, and Visuals

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

© 2012 Microsoft. All rights reserved.

Terms of Use | Trademarks | Privacy Statement | Site Feedback Site Feedback

Site Feedback

x

Tell us about your experience...

Did the page load quickly?

Yes No

Do you like the page design?

Yes No

Tell us more