Create custom-shaped marker for Graph's legend items

AUTHOR: Ivan Hristov

DATE MODIFIED : April 25, 2018

DATE POSTED: August 09, 2017

Article information
Article relates to	Telerik Reporting R3 2016+
Created by	Ivan, Telerik
Last modified	August 23th, 2016

PROBLEM
How to change the default Graph's legend item markers with a custom ones?

SOLUTION
The Graph's uses the same markers for its series and their respective legend items. Occasionally it makes sense to substitute the legend markers with custom ones for better presentation effect. This can be achieved using a background image that supports transparency (i.e. PNG) and set it as LegendItem.MarkStyle.BackgroundImage. The transparent area on the image will allow the default series color to be displayed onto the legend marker. Using this approach, the pie chart legend can be presented using circular marks, as shown below:


Note: The default series marker is created using drawing path primitives, therefore it is scalable without quality loss. Using a background image, however, might lead to distorted images on higher zoom levels, because of the resized raster images.