Vcl.Graphics.TCanvas.StretchDraw

• Up to Parent: TCanvas

Delphi

procedure StretchDraw(const Rect: TRect; Graphic: TGraphic); override;

C++

virtual void __fastcall StretchDraw(const Winapi::Windows::TRect &Rect, TGraphic* Graphic);

Properties

Type	Visibility	Source	Unit	Parent
procedure function	public	Vcl.Graphics.pas Vcl.Graphics.hpp	Vcl.Graphics	TCanvas

Description

Draws the graphic specified by the Graphic parameter in the rectangle specified by the Rect parameter.

Call StretchDraw to draw a graphic on the canvas so that the image fits in the specified rectangle. StretchDraw calls the Draw method of the graphic. The graphic object determines how to fit into the rectangle. This may involve changing magnification and/or aspect ratio.

To render the graphic in its natural size, use the Draw method, instead.

If the graphic is a TBitmap object, the bitmap is rendered using the value of CopyMode.

Note: If the graphic is an icon, it is not stretched.

See Also

• CopyMode

• CopyRect

• Draw

Code Examples

• TVCustomDraw (Delphi)
• TVCustomDraw (C++)