SeriesPointAnimationActionCollection Class
Represents a collection of animation actions that animate series points.
Namespace: DevExpress.Xpf.Charts
Assembly: DevExpress.Xpf.Charts.v24.2.dll
NuGet Package: DevExpress.Wpf.Charts
Declaration
public class SeriesPointAnimationActionCollection :
ChartElementCollection<SeriesPointAnimationAction>
Related API Members
The following members return SeriesPointAnimationActionCollection objects:
Remarks
The SeriesPointAnimationActionCollection class represents a collection of SeriesPointAnimationAction objects that represent series point animation actions. Its properties and methods can be used to perform common collection operations such as adding new or deleting existing items. Individual items can be accessed using indexer notation.
A collection of animation actions can be accessed via the series point animation’s SeriesPointAnimation.Actions property.
Example
The following example demonstrates how to animate series points, so that their values are dynamically changed when displaying a chart.
To accomplish this, it is first necessary to add a trigger to a chart’s Triggers collection, which will start the Year1998Animation in response to the chart’s Loaded event. Then, to the ChartControl.AnimationRecords collection, add a ChartAnimationRecord with a SeriesAnimation object.
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts"
x:Class="WpfApplication1.Window1" Height="500" Width="650">
<Grid>
<dxc:ChartControl x:Name="chart">
<dxc:ChartControl.Diagram>
<dxc:XYDiagram3D>
<!--region #series-->
<dxc:XYDiagram3D.Series>
<dxc:BarSeries3D x:Name="Year1998" >
<dxc:Series.Points>
<dxc:SeriesPoint Argument="Illinois" Value="423.72" />
<dxc:SeriesPoint Argument="Indiana" Value="178.71" />
<dxc:SeriesPoint Argument="Michigan" Value="308.84" />
<dxc:SeriesPoint Argument="Ohio" Value="348.54" />
<dxc:SeriesPoint Argument="Wisconsin" Value="160.27" />
</dxc:Series.Points>
<dxc:BarSeries3D.Label>
<dxc:SeriesLabel Visible="False"/>
</dxc:BarSeries3D.Label>
</dxc:BarSeries3D>
<!--endregion #series-->
</dxc:XYDiagram3D.Series>
</dxc:XYDiagram3D>
</dxc:ChartControl.Diagram>
<!--region #records-->
<dxc:ChartControl.AnimationRecords>
<dxc:ChartAnimationRecord x:Name="Year1998Animation" Progress="0">
<dxc:ChartAnimationRecord.Animations>
<dxc:SeriesAnimation TargetSeries="{Binding ElementName=Year1998}">
<dxc:SeriesAnimation.Actions>
<dxc:SeriesSeriesPointsAction EqualSpeed="True"
Sequential="True"
DelayPercentage="30"/>
</dxc:SeriesAnimation.Actions>
</dxc:SeriesAnimation>
</dxc:ChartAnimationRecord.Animations>
</dxc:ChartAnimationRecord>
</dxc:ChartControl.AnimationRecords>
<!--endregion #records-->
<!--region #triggers-->
<dxc:ChartControl.Triggers>
<EventTrigger RoutedEvent="dxc:ChartControl.Loaded">
<EventTrigger.Actions>
<BeginStoryboard>
<Storyboard>
<DoubleAnimation From="0" To="1" Duration="0:0:3"
Storyboard.TargetName="Year1998Animation"
Storyboard.TargetProperty="Progress" />
</Storyboard>
</BeginStoryboard>
</EventTrigger.Actions>
</EventTrigger>
</dxc:ChartControl.Triggers>
<!--endregion #triggers-->
</dxc:ChartControl>
</Grid>
</Window>