Property ULImage.TULImage.Proportional

From Mitov Wiki Doc
Revision as of 00:25, 22 November 2011 by David Alm (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This is a Beta Read Only version of this page. Please review and send recommendations to We will enable the editing as soon as we are happy with the overall Wiki site.

Class: TULImage




property Proportional : Boolean read FProportional write SetProportional default False;

C++ Builder:

__property bool Proportional = { read=FProportional, write=SetProportional, default=False };


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.

The default value for Proportional is false.

Personal tools