Vcl.ExtCtrls.TImage.Canvas

• Up to Parent: TImage

Delphi

property Canvas: TCanvas read GetCanvas;

C++

__property Vcl::Graphics::TCanvas* Canvas = {read=GetCanvas};

Properties

Type	Visibility	Source	Unit	Parent
property	public	Vcl.ExtCtrls.pas Vcl.ExtCtrls.hpp	Vcl.ExtCtrls	TImage

Description

Provides a drawing surface for embellishing bitmap images.

Canvas is the TCanvas object on which the image for the TImage component is drawn. The painting of the image specified in the Picture property is automatic and does not require manual intercession for the picture to appear.

You can use properties and methods of TCanvas to do such things as draw lines, draw images, and write text to the canvas of the TImage control.

Note: Canvas is only available if the Picture property represents a TBitmap object. Trying to read Canvas when Picture represents another type of graphic image causes TImage to raise an EInvalidOperation exception.

See Also

• EInvalidOperation

• Picture

• TCanvas

• TBitmap

• EInvalidOperation

Code Examples

• ClipRect (Delphi)
• SaveToFile (Delphi)
• TImageCanvas (Delphi)
• ClipRect (C++)
• SaveToFile (C++)
• TImageCanvas (C++)