This property sets whether or not an Image annotation object, when pasted or altered, will maintain the aspect ratio of the original image and whether or not a Rectangle, RoundRectangle and Ellipse annotation object, when altered, will maintain its aspect ratio.
Property Value
True: The object's aspect ratio or the aspect ratio of the image
will be maintained
False: The image can be pasted or resized without regard to the
aspect ratio
The default value is True
Explanation
The AspectRatio property sets whether or not certain annotation objects maintain their aspect ratio (height/width) when they are being resized. The annotation objects that are affected by the AspectRatio property are the Rectangle, RoundRectangle, and Ellipse objects. The AspectRatio property also sets whether or not an image being loaded into an Image annotation will maintain its aspect ratio.
How the AspectRatio property affects the annotation object depends on which object it applies to.
Rectangle, RoundRectangle, and Ellipse annotation
objects:
When the AspectRatio property is true and the Rectangle,
RoundRectangle, or Ellipse annotation objects are being resized, by
pressing down the shift key while resizing the object with the
mouse, the aspect ratio will be maintained. If the shift button is
not pressed down, the aspect ratio is not maintained.
When the AspectRatio property is false and the Rectangle, RoundRectangle, or Ellipse annotation objects are being resized, by pressing down the shift key while resizing the object with the mouse, the aspect ratio will be 1:1. If the shift button is not pressed down, the aspect ratio is not maintained.
Image object
When the AspectRatio property is true and an Image
annotation object is placed on the ImageKit control, the image
loaded into the Image annotation object will keep its aspect ratio.
In other words, the image will be "scaled" to fit within the image
annotation object. When the AspectRatio property is false
and an image annotation object is placed on the ImageKit control,
the image will be stretched to fill the entire image annotation
object. The image's original aspect ratio will not be
maintained.
When an Image annotation object is resized using the mouse, the AspectRatio property has no affect. It is the SelectedObjectAspectRatio property that determines if the image's original aspect ratio will be maintained when the Image annotation object is being resized. When the SelectedObjectAspectRatio property is true and the image is resized using the mouse, the image's original aspect ratio will be maintained while it is being resized. When the SelectedObjectAspectRatio property is false and the image annotation object is being resized using the mouse, then the image object's aspect ratio will be 1:1.
To make changes to the aspect ratio after the object has been drawn, right click on the object to display the context menu or execute the ShowPropertyDialog method to display the property dialog.
Also See
ImageKit.Edit Members | Newtone.ImageKit.Wpf.ImageKit