TcxCustomImageProperties.FitMode Property
Specifies how the image editor fits and positions an image.
Declaration
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 toTrue
(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.