proportionalimage Proportional property
Return to Introduction  Previous page  Next page
Applies to
acProportionalImage property.  

Declaration
property Proportional: Boolean;  

Description
The Proportional property indicates whether the image should be changed, without distortion, so that it fits the bounds of the image control.  
 
Set Proportional to True to ensure that the image can be fully displayed in the image control without any distortion such as occurs with the Stretch property. When Proportional is True, images that are too large to fit in the image control are scaled down (while maintaining the same aspect ratio) until they fit in the image control. Images that are too small are displayed normally. That is, Proportional can reduce the magnification of the image, but does not increase it.  
 
When the image control resizes, the image resizes also.  
 
To resize the image so that it fits exactly in the image control, even if that causes distortion, use the Stretch property instead.  
 
To resize the control to the image rather than resizing the image to the control, use the AutoSize property instead.  
 
Note:   Proportional has no effect if the Picture property contains an icon.  
 
tip Use DrawRect property to determinate the bounds of drawn image (not image control).  

See also
AutoSize, Stretch and DrawRect properties.