TcxCanvas.Pixels Property

Provides access to any pixel within the clip area on the canvas.

Declaration

property Pixels[X: Integer; Y: Integer]: TColor write;

Property Value

Type	Description
TColor	A pixel color.

Remarks

Pass pixel coordinates as the X and Y parameters to identify or change color of any pixel within the clip area. The Pixels property returns -1 if the specified pixel is outside the clip area or the device context does not support indexed access to pixels on the canvas.

Indexed pixel access is a slow operation. To draw individual pixels on the canvas, call the FillPixel procedure instead.

Note

The Pixels property maps to the Pixels property of the underlying canvas.