Series3DDataSourceAdapter.CustomizeSeries Event

Occurs every time the data source adapter generates series from the underlying data source.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v24.2.dll

NuGet Package: DevExpress.Wpf.Charts

Declaration

C#

public event CustomizeSeriesEventHandler CustomizeSeries

VB.NET

Public Event CustomizeSeries As CustomizeSeriesEventHandler

Event Data

The CustomizeSeries event's data class is CustomizeSeriesEventArgs. The following properties provide information specific to this event:

Property	Description
Handled	Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route. Inherited from RoutedEventArgs.
OriginalSource	Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs.
RoutedEvent	Gets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs.
Series	Returns the series whose parameters should be fine-tuned.
Source	Gets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs.

The event data class exposes the following methods:

Method	Description
InvokeEventHandler(Delegate, Object)	When overridden in a derived class, provides a way to invoke event handlers in a type-specific way, which can increase efficiency over the base implementation. Inherited from RoutedEventArgs.
OnSetSource(Object)	When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes. Inherited from RoutedEventArgs.

Remarks

You can handle this event to fine-tune automatically generated series.

Example

XAML

<!--...-->
<dxc:Series3DDataSourceAdapter SeriesDataMember="Category" 
                               XArgumentDataMember="X" 
                               YArgumentDataMember="Y" 
                               ValueDataMember="Value" 
                               DataSource="{Binding DataPoints}"
                               CustomizeSeries="Series3DDataSourceAdapter_CustomizeSeries">
<!--...-->                                           

C#

private void Series3DDataSourceAdapter_CustomizeSeries(object sender, DevExpress.Xpf.Charts.CustomizeSeriesEventArgs e) {
    if (e.Series.DisplayName == "Phones") {
        ((Point3DSeriesView)e.Series.View).Colorizer = new SolidColorizer3D { 
            Brush = new System.Windows.Media.SolidColorBrush { 
                Color = Colors.Red 
            } 
        };
    }
}

VB.NET

Private Sub Series3DDataSourceAdapter_CustomizeSeries(ByVal sender As Object, ByVal e As DevExpress.Xpf.Charts.CustomizeSeriesEventArgs)
    If e.Series.DisplayName Is "Phones" Then
        CType(e.Series.View, Point3DSeriesView).Colorizer = New SolidColorizer3D With {
            .Brush = New System.Windows.Media.SolidColorBrush With {
                .Color = Colors.Red
            }
        }
    End If
End Sub