TCustomImage.SizeMode Property

Specifies the active image size calculation mode.

Declaration

property SizeMode: TSizeMode read; write; default TSizeMode.StretchImage;

Property Value

Type	Default	Description
TdxSplashFormBase.TCustomImage.TSizeMode	StretchImage	The active image size calculation mode.

Remarks

Use the SizeMode property to switch between available image size calculation modes.

Available Options

TdxSplashFormBase.TCustomImage.TSizeMode.StretchImage

Default. The displayed image is resized to fill the widget area. This option ignores the original image aspect ratio.

TdxSplashFormBase.TCustomImage.TSizeMode.ProportionalStretchImage

The displayed image is resized to fill the widget area. The image maintains the original aspect ratio and is centered within the widget area.

TdxSplashFormBase.TCustomImage.TSizeMode.UseImageDimensions

The displayed image is not resized. Widget area dimensions are adjusted automatically to match the image size. You cannot resize the Image widget in this mode.

This option is recommended for raster image formats.

Default Value

The SizeMode property’s default value is StretchImage.