IXRStoryboard::SeekAlignedToLastTick (Windows Embedded CE 6.0)

Article
01/05/2012

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

Share via