The requested page is not available for the requested platform. You are viewing the content for Default platform.

XRChart.CustomDrawSeries Event

Occurs before a series is drawn when the chart's contents are being drawn.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.2.dll

Declaration

public event CustomDrawSeriesEventHandler CustomDrawSeries
Public Event CustomDrawSeries As CustomDrawSeriesEventHandler

Event Data

The CustomDrawSeries event handler receives an argument of the CustomDrawSeriesEventArgs type. The following properties provide information specific to this event.

Property Description
DisposeLegendCheckBoxImage Gets or sets the value specifying whether CustomDrawSeriesEventArgs.LegendCheckBoxImage should be disposed when drawing is finished.
DisposeLegendFont Gets or sets the value specifying whether the CustomDrawSeriesEventArgsBase.LegendFont should be disposed when drawing is finished.
DisposeLegendMarkerImage Gets or sets the value specifying whether CustomDrawSeriesEventArgsBase.LegendMarkerImage should be disposed when drawing is finished.
LegendCheckBoxImage Gets or sets the image of the legend item check box of the series or series point that is currently being painted.
LegendCheckBoxImageSizeMode Gets or sets the image size mode of the legend item check box of the series or series point that is currently being painted.
LegendCheckBoxSize Gets or sets the size of the legend item check box of the series or series point that is currently being painted.
LegendCheckBoxVisible Gets or sets the visibility of the legend item check box of the series that is currently being painted.
LegendDrawOptions Returns the draw settings of the legend item of the series that is currently being drawn.
LegendFont Gets or sets the text font of the legend item of the series or series point that is currently being painted.
LegendMarkerImage Gets or sets the image of the legend item marker of the series or series point that is currently being painted.
LegendMarkerImageSizeMode Gets or sets the image size mode of the legend item marker of the series or series point that is currently being painted.
LegendMarkerSize Gets or sets the size of the legend item marker of the series or series point that is currently being painted.
LegendMarkerVisible Gets or sets the visibility of the legend item marker of the series or series point that is currently being painted.
LegendText Gets or sets the text of the legend item of the series or series point that is currently being painted.
LegendTextColor Gets or sets the text color of the legend item of the series or series point that is currently being painted.
LegendTextVisible Gets or sets the text visibility of the legend item of the series whose points are currently being drawn.
Series Returns the series that is currently being painted.
SeriesDrawOptions Returns the draw settings of the series that is currently being drawn.

Remarks

The CustomDrawSeries event is raised before every series is painted. The event parameter's Series property provides the series which enables the series view and other specific series options to be determined. And the SeriesDrawOptions property provides the drawing options specific to each series. Note that the return value of this property should be typecast to the corresponding type (e.g., BarDrawOptions).

Examples

This example demonstrates how to implement custom drawing in charts when drawing its series. To do this, you should handle the XRChart.CustomDrawSeries event, and then you're able to change some drawing parameters using its event args.

using DevExpress.XtraCharts;
// ...

private void xrChart1_CustomDrawSeries(object sender, CustomDrawSeriesEventArgs e) {
   // Find all Bar Series by their view type,
   // and fill them with Aqua color.
   if (e.Series.View is BarSeriesView)
      e.SeriesDrawOptions.Color = Color.Aqua;

   // Find the series by its name, and change its line style to dash-dot-dot.
   // (Here it's assumed that the series view type is LineSeriesView).
   if (e.Series.Name == "Line Series") 
      ((LineDrawOptions)e.SeriesDrawOptions).LineStyle.DashStyle = DashStyle.DashDotDot;

   // Find all Point Series by the type of its DrawOptions, 
   // and change their marker kind to diamond.
   if (e.SeriesDrawOptions.GetType() == typeof(PointDrawOptions)) 
      ((PointDrawOptions)e.SeriesDrawOptions).Marker.Kind = MarkerKind.Diamond;
}
See Also