次の方法で共有


IXRPointAnimation::SetBy (Windows Embedded CE 6.0)

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

See Also

Reference

IXRPointAnimation
IXRPointAnimation::GetBy