TImage.Proportional Property

Indicates whether the image should be changed, without distortion, so that it fits the bounds of the image control.

Pascal

property Proportional: Boolean;

C++

__property Boolean Proportional;

Description

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.

The default value for Proportional is false.

Note: Proportional has no effect if the Picture property contains an icon.