TcxCustomImageProperties.FitMode Property

Specifies how the image editor fits and positions an image.

Declaration

delphi

property FitMode: TcxImageFitMode read; write; default ifmFit;

Property Value

Type	Default	Description
TcxImageFitMode	ifmFit

The active image fit mode.

Remarks

Use the FitMode property to switch between available image display modes.

Property Values

ifmFit (default)

An image is not resized if it fits into the editor’s boundaries. Otherwise, the image shrinks proportionally to fit into the editor.

ifmNormal

An image is not resized to fit into the editor’s boundaries. In this mode, the editor displays a zoom track bar if the editor’s ZoomingOptions.ShowZoomTrackBar property is set to True. If the zoom track bar is hidden, users can still rotate the mouse wheel while holding the Ctrl key to zoom the displayed image in or out.

In addition, the editor displays scroll bars that allow users to pan the displayed image when it does not fit into the editor and the Center property is set to False. If the Center property is set to True ( default ), the image is always centered and scroll bars are hidden.

ifmFill

A centered image is stretched or shrunk to fill the editor. The image maintains its aspect ratio and can leave blank areas within the image editor.

Refer to the TcxImageFitMode type description for detailed information on all available options.

Default Value

The FitMode property’s default value is ifmFit.