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

GaugeControlBase.EnableAnimation Property

Gets or sets a value specifying whether value indicators should be animated when changing their values.

Namespace: DevExpress.Xpf.Gauges

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

NuGet Package: DevExpress.Wpf.Gauges

#Declaration

public bool EnableAnimation { get; set; }

#Property Value

Type Description
Boolean

true to enable animation; otherwise, false.

#Remarks

When the EnableAnimation property is set to true, all value indicators of a Gauge control will smoothly display changing values. Note that an indicator’s ValueIndicatorBase.Value can be changed either programmatically or by using a mouse-click (when the ValueIndicatorBase.IsInteractive property of the corresponding indicator is set to true).

By default, the preset animation effect is used. If you want to change default settings, you should edit the ValueIndicatorBase.Animation property of a value indicator (e.g. to change the animation duration or animation function). For more details, refer to How to: Customize Animation Settings.

Use the AnimationBase.Enable property to animate (inanimate) a concrete gauge’s indicator, if the GaugeControlBase.EnableAnimation property is set to false (true).

#Example

This example demonstrates how to use animation effects in DXGauges.

To activate animation, set the GaugeControlBase.EnableAnimation property to True. After that, it becomes possible to customize the animation’s duration and easing function via its IndicatorAnimation.Duration and IndicatorAnimation.EasingFunction properties.

<Window x:Class="DXGauges_Animation.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:dxga="http://schemas.devexpress.com/winfx/2008/xaml/gauges"
        Title="MainWindow" Height="350" Width="525" >
    <Grid>
        <!--region #EnableAnimation-->
        <dxga:CircularGaugeControl EnableAnimation="True">
        <!--endregion #EnableAnimation-->
            <dxga:CircularGaugeControl.Scales>
                <dxga:ArcScale>
                    <dxga:ArcScale.Needles>
                        <!--region #EnableEditing-->
                        <dxga:ArcScaleNeedle IsInteractive="True">
                        <!--endregion #EnableEditing-->
                            <dxga:ArcScaleNeedle.Animation>
                                <dxga:IndicatorAnimation Duration="00:00:02.0000000">
                                    <dxga:IndicatorAnimation.EasingFunction>
                                        <BounceEase/>
                                    </dxga:IndicatorAnimation.EasingFunction>
                                </dxga:IndicatorAnimation>
                            </dxga:ArcScaleNeedle.Animation>
                        </dxga:ArcScaleNeedle>
                    </dxga:ArcScale.Needles>
                </dxga:ArcScale>
            </dxga:CircularGaugeControl.Scales>
        </dxga:CircularGaugeControl>
    </Grid>
</Window>
See Also