IXRPointAnimation::SetBy (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

This method sets the total amount by which the animation changes its starting value.

Syntax

virtual HRESULT STDMETHODCALLTYPE SetBy(
    XRPoint* pBy
) = 0;

Parameters

pBy
[in] XRPoint structure that specifies the x-coordinate and the y-coordinate of the animation increment.

Return Value

Returns an HRESULT that indicates success of failure.

Remarks

Use this method when you want to animate a value by a specific increment, instead of by specifying a starting or ending value. You can also use the SetBy method together with the SetFrom method. The following table shows how these methods can be used together or separately to determine an animation's target values.

Method(s) used by the developer	Resulting behavior
SetFrom	The animation progresses from the value specified in SetFrom to the animated property's base value or to a previous animation's output value, depending on how the previous animation is configured.
SetFrom and SetTo	The animation progresses from the value specified in SetFrom to the value specified in SetTo.
SetFrom and SetBy	The animation progresses from the value specified in SetFrom to the sum of values specified in SetFrom and SetBy.
SetTo	The animation progresses from the animated property's base value or a previous animation's output value to the value specified in SetTo.
SetBy	The animation progresses from the animated property's base value or from a previous animation's output value to the sum of that value and the value specified in SetBy.

If you use both the SetTo and SetBy methods, the value specified in SetTo takes precedence and the SetBy property is ignored.

To use other interpolation methods or to animate between more than two target values use the IXRPointAnimationUsingKeyFrames object.

Inheritance Hierarchy

IXRDependencyObject

IXRTimeline

IXRPointAnimation

.NET Framework Equivalent

System.Windows.Media.Animation.PointAnimation.By

Requirements

Header	XamlRuntime.h
sysgen	SYSGEN_XAML_RUNTIME
Windows Embedded CE	Windows Embedded CE 6.0 R3

Share via