Developer Tools and Languages

.NET Framework 4.5

.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

GeometryCollection Class

GeometryCollection.Enumerator Structure

GeometryCombineMode Enumeration

GeometryConverter Class

GeometryDrawing Class

GeometryGroup Class

GeometryHitTestParameters Class

GeometryHitTestResult 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

VectorCollection Class

VectorCollection.Enumerator Structure

VectorCollectionConverter Class

VideoDrawing Class

Visual Class

VisualBrush Class

VisualCollection Class

VisualCollection.Enumerator Structure

VisualTarget Class

VisualTreeHelper Class

Minimize

1 out of 1 rated this helpful - Rate this topic

Stretch Enumeration

.NET Framework 4.5

Describes how content is resized to fill its allocated space.

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

public enum Stretch

XAML Attribute Usage

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

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


// 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, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), 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)

© 2013 Microsoft. All rights reserved.