TdxCustomContainerReportLink.OnCustomDrawItem Event

Occurs before painting of a specific container item.

Declaration

property OnCustomDrawItem: TdxContainerReportLinkCustomDrawItemEvent read; write;

Remarks

To implement custom painting of the container item (aggregated component) within the report you should use the OnCustomDrawItem event and enable the custom painting via the SupportedCustomDraw property. Set it to True to enable custom painting and to False to disable it.

To implement custom painting you will need a canvas to paint to (provided by ACanvas parameter) and painting information provided by the AnItem parameter. Optionally you can access owning report link properties and methods via the Sender parameter and the component currently painted via the AComponent parameter.

To prevent default drawing of the container header set the ADone parameter to True. By default, the ADone parameter is False and default drawing is enabled.

Refer to the global FSmoothlyStretchImages variable description to learn how to paint images with anti-aliasing.

Note

Printing a report for a container control automatically fires the OnCustomDraw~ events of report links created for its child controls. The custom painting is a very resource consuming operation, it may significantly increase report rendering time. You should use it only when extremely necessary.