Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxCustomContainerReportLink.OnCustomDrawItem Event

In This Article

Occurs before painting of a specific container item.

#Declaration

Delphi
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.

See Also