PowerEase class (Windows)

This topic has not yet been rated - Rate this topic

Represents an easing function that creates an animation that accelerates and/or decelerates using the formula f(t) = tp where p is equal to the Power property.

Inheritance

Object
DependencyObject
EasingFunctionBase
PowerEase

Syntax

C++


public sealed class PowerEase : EasingFunctionBase

XAML Object Element Usage


<PowerEase .../>

Attributes

ActivatableAttribute(NTDDI_WIN8)
MarshalingBehaviorAttribute(Agile)
StaticAttribute(Windows.UI.Xaml.Media.Animation.IPowerEaseStatics, NTDDI_WIN8)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)
WebHostHiddenAttribute()

Members

The PowerEase class has these types of members:

Constructors
Methods
Properties

Constructors

The PowerEase class has these constructors.

Constructor	Description
PowerEase	Initializes a new instance of the PowerEase class.

Methods

The PowerEase class has these methods. It also inherits methods from the Object class.

Method	Description
ClearValue	Clears the local value of a dependency property. (Inherited from DependencyObject)
Ease	Transforms normalized time to control the pace of an animation. (Inherited from EasingFunctionBase)
GetAnimationBaseValue	Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Inherited from DependencyObject)
GetValue	Returns the current effective value of a dependency property from a DependencyObject. (Inherited from DependencyObject)
ReadLocalValue	Returns the local value of a dependency property, if a local value is set. (Inherited from DependencyObject)
SetValue	Sets the local value of a dependency property on a DependencyObject. (Inherited from DependencyObject)

Properties

The PowerEase class has these properties.

Property	Access type	Description
Dispatcher	Read-only	Gets the CoreDispatcher that this object is associated with. (Inherited from DependencyObject)
EasingMode	Read/write	Gets or sets a value that specifies how the animation interpolates. (Inherited from EasingFunctionBase)
Power	Read/write	Gets or sets the exponential power of the animation interpolation. For example, a value of 7 creates an animation interpolation curve that follows the formula f(t) = t 7.
PowerProperty	Read-only	Identifies the Power dependency property.

Remarks

A PowerEase can be used to produce the same results as some of the other easing functions, depending on how Power is set. For example, a CubicEase is the same as a PowerEase with Power of 3.

Power is a Double value so can be used to set non-integer values. For example you could use a Power of 2.5 to produce an easing function has a sharper curve than QuadraticEase but not as sharp as CubicEase.

An easing function can be applied to the EasingFunction properties of From/To/By animations, or to the EasingFunction properties of key-frame types used for the Easing variants of key-frame animations. For more info, see Key-frame animations and easing function animations.

Examples

This XAML example applies a PowerEase easing function with a Power property value of 20 to a DoubleAnimation to create a decelerating animation. Because the Power value is so high, the deceleration is sudden compared to what it would be if you used a lower value.

XAML


<StackPanel x:Name="LayoutRoot" >
    <StackPanel.Resources>
        <Storyboard x:Name="myStoryboard">
            <DoubleAnimation From="1" To="6" Duration="00:00:3" 
             Storyboard.TargetName="rectScaleTransform" 
             Storyboard.TargetProperty="ScaleY">
                <DoubleAnimation.EasingFunction>
                    <PowerEase Power="20" EasingMode="EaseOut"/>
                </DoubleAnimation.EasingFunction>
            </DoubleAnimation>
        </Storyboard>
    </StackPanel.Resources>

    <Rectangle PointerPressed="Pointer_Clicked" 
     Fill="Blue" Width="200" Height="30">
        <Rectangle.RenderTransform>
            <ScaleTransform x:Name="rectScaleTransform" />
        </Rectangle.RenderTransform>
    </Rectangle>

    </StackPanel>


// When the user clicks the rectangle, the animation
// begins. 
private void Pointer_Clicked(object sender, PointerRoutedEventArgs e)
{
    myStoryboard.Begin();
}

Requirements

Minimum supported client	Windows 8 [Windows Store apps only]
Minimum supported server	Windows Server 2012 [Windows Store apps only]
Namespace	Windows.UI.Xaml.Media.Animation Windows::UI::Xaml::Media::Animation [C++]
Metadata	Windows.winmd

PowerEase class