TImageEnView.AutoStretch

Declaration

property AutoStretch: Boolean;

Description

When enabled the following display rules are used:
◼If an image is bigger than TImageEnView window it is displayed 100%;
◼If an image is smaller than TImageEnView window it is stretched to fit

Note:
◼Changes will not take effect until you call Update (or update the display by zooming or loading an image, for example). To make it automatically update, add iedoDisableAutoFitWhenZoom to DisplayOptions
◼To fit only to width or height, use FitMode
◼To automatically crop the view so the image takes up more of the control area, enable FitCropping

Default: False

Example

procedure TForm1.chkAutoStretchClick(Sender: TObject);
begin
  ImageEnView1.AutoStretch := chkAutoStretch.Checked;
  if not chkAutoStretch.Checked then
    ImageEnView1.Zoom := 100
  else
    ImageEnView1.Fit();
end;

See Also

◼AutoShrink
◼loFitToLayersWhenZooming
◼iedoDisableAutoFitWhenZoom

Compatibility Information

Prior to v14.0.0 there was an AutoFit property that set AutoStretch and AutoShrink. Code that was:
ImageEnView1.AutoFit := True;
Should be changed to:
ImageEnView1.AutoShrink  := True;
ImageEnView1.AutoStretch := True;

---