TPostScriptPrinterCanvas.StretchDraw procedure

Declaration

procedure StretchDraw(const DestRect: TRect; SrcGraphic: TGraphic)
 ; override

Description

Not described here; this is what TCanvas.StretchDraw says of it:

Expands or contracts the specific graphic content to fit the specified destination rectangle on the canvas.

StretchDraw is a reintroduced method in TCanvas; it reimplements the inherited method to use the specified TGraphic content in the drawing operation instead of a TFPCustomImage instance.

No actions are performed in the method if SrcGraphic has not been assigned.

DestRect provides the rectangular area on the canvas where the graphic content is drawn. The Draw method in SrcGraphic is called to draw the image content onto the canvas instance. If the dimensions in DestRect differ from the Width or Height in SrcGraphic, the image content is expanded or contracted to fit the destination rectangle. This may causes the aspect ratio for the image content to be changed.

StretchDraw calls Changing to signal an assigned OnChanging event handler immediately before the drawing operation. It calls Changed to signal an assigned OnChange event handler when the drawing operation has been completed.