TdxBackground.OnPaintEx Event

Occurs when painting report background.

Declaration

property OnPaintEx: TCustomdxBackgroundPaintExEvent read; write;

Remarks

The OnPaintEx event handler is used to perform specific actions when painting a report background. The main difference between the OnPaint and OnPaintEx events is that the latter operates with logical size units.

The Canvas parameter specifies the drawing surface.

The Rect parameter determines the rectangle where to draw the background.

The ADone parameter determines whether the OnPaintEx event handler completely draws the background. If ADone is True, the default paint procedure is not called.

The PixelsNumerator and PixelsDenominator parameters are used to convert object size in pixels to logical units. In order to calculate width/height of an object in logical units, you should multiply this width/height in pixels by the PixelsNumerator parameter and divide the result by the PixelsDenominator parameter.

The ASequence parameter determines whether the DoPaintEx method was called before or after background painting. Available values include:

Value	Description
psBefore	DoPaintEx called before background painting.
psAfter	DoPaintEx called after background painting.