This documentation is archived and is not being maintained.

BitmapSizeOptions.PreservesAspectRatio Property

Gets a value that determines whether the aspect ratio of the original bitmap image is preserved.

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

public bool PreservesAspectRatio { get; }
/** @property */
public boolean get_PreservesAspectRatio ()

public function get PreservesAspectRatio () : boolean

You cannot use this property in XAML.

Property Value

true if the original aspect ratio is maintained; otherwise, false.

If the original aspect ratio is preserved, PixelWidth and PixelHeight represent the maximum size values for the bitmap. The resulting bitmap is only guaranteed to have either its width or its height match the specified values. If the aspect ratio is not preserved, the specified PixelWidth and PixelHeight are both used, and the bitmap is stretched to use those values.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0