Share via


IXRStoryboard::SeekAlignedToLastTick (Windows Embedded CE 6.0)

1/6/2010

This method advances this storyboard from the current position to a new position based on a specified time increment (synchronously).

Syntax

virtual HRESULT STDMETHODCALLTYPE SeekAlignedToLastTick(
    XRTimeSpan *pTimeSpan
) = 0;

Parameters

  • pTimeSpan
    [in] XRTimeSpan structure that represents a positive or negative time value that describes how far the timeline should move forward or backward from the beginning of the animation.

Return Value

Returns an HRESULT that indicates success or failure.

This method can also return one of the following error messages, which can apply to either the storyboard itself, or to its animations in the collection retrieved by IXRStoryboard::GetChildren:

Error message Description

XR_E_STORYBOARD_BEGIN_INVALID_PROPERTY

Silverlight for Windows Embedded cannot begin this storyboard. The property to be animated is invalid.

XR_E_STORYBOARD_BEGIN_INVALID_TARGET

Silverlight cannot begin this storyboard. The specified target is invalid.

XR_E_STORYBOARD_BEGIN_NO_TARGET

Silverlight cannot begin this storyboard. There is no target to animate.

XR_E_STORYBOARD_BEGIN_INCOMPATIBLE_TYPE

Silverlight cannot begin this storyboard. There is no conversion available between the target properties and object.

XR_E_STORYBOARD_BEGIN_ANIMATION_COMPOSITION

Silverlight cannot compose this animation with the currently running animation.

XR_E_STORYBOARD_BEGIN_INVALID_KEYTIME

Invalid key-time specified for the beginning of this storyboard.

XR_E_STORYBOARD_MUST_BE_ROOT 

Storyboard must be the root element of this timeline collection.

XR_E_STORYBOARD_SKIPTOFILL_NO_DURATION

No valid duration specified for this skip-to-fill operation.

XR_E_STORYBOARD_MODIFY_ACTIVE_ANIMATION

Silverlight cannot modify this active animation.

Remarks

The time change specified by this method is added or subtracted from the last clock tick of this clock's animation. Values changed by SeekAlignedToLastTick are immediately updated, even though the window does not reflect these changes until it updates.

If this method is called when the storyboard begins, either right before or immediately after IXRStoryboard::Begin is called, the behavior for this method is the same as IXRStoryboard::Seek.

.NET Framework Equivalent

System.Windows.Media.Animation.Storyboard.SeekAlignedToLastTick

Requirements

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

See Also

Reference

IXRStoryboard