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 |