MaintainAspectRatio Property

Gets or sets a value which indicates whether the aspect ratio of the image should be maintained when creating the thumbnail.

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public bool MaintainAspectRatio {get; set;}

'Declaration
 
Public Property MaintainAspectRatio As Boolean

'Usage
 
Dim instance As CodecsThumbnailOptions
Dim value As Boolean
 
instance.MaintainAspectRatio = value
 
value = instance.MaintainAspectRatio

public bool MaintainAspectRatio {get; set;}

 get_MaintainAspectRatio();
 set_MaintainAspectRatio(value);

public:
property bool MaintainAspectRatio {
   bool get();
   void set (    bool value);
}

Property Value

true to indicates that the aspect ratio of the image should be maintained when creating the thumbnail; false, otherwise.

Remarks

When set to true, the generated thumbnail's width and height will not match both Width and Height if the original aspect ratio was not 1:1.

If you desire the thumbnail be generated with exactly the requested width and height while still maintaining the aspect ratio of the actual image, set both MaintainAspectRatio and ForceSize to true.

Example

For an example, refer to RasterCodecs.ReadThumbnail.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

CodecsThumbnailOptions Structure
CodecsThumbnailOptions Members