Share via


IXRTimeline::SetBeginTime (Windows Embedded CE 6.0)

1/6/2010

This method sets the time at which this timeline should begin.

Syntax

virtual HRESULT STDMETHODCALLTYPE SetBeginTime(
    XRTimeSpan* pBeginTime
) = 0;

Parameters

  • pBeginTime
    [in] Pointer to an XRTimeSpan structure that indicates the start time of the time line. This defines the time delay before the animation begins.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

This method is useful for creating timelines that play in sequence. You can stagger play times by increasing the pBeginTime of successive timelines that share the same parent IXRStoryboard.

You can also set this value at run-time by calling SetBeginTime. The value will apply the next time that animation begins.

Leaving the default null value for pBeginTime has the same effect on an animation as an XRTimeSpan that is explicitly set to 0.

A negative value for pBeginTime causes an IXRTimeline to behave as if it started at some time in the past. For example, when GetBeginTime retrieves a begin time of -2.5 seconds and IXRTimeline::GetDuration retrieves a duration of 5 seconds, the timeline will start at the halfway point.

The time described by pBeginTime is measured relative to the time of the parent of the timeline. For example, a timeline with a begin time of 5 seconds whose parent has a speed ratio of 2 actually starts after a 2.5 second delay.

A timeline's own speed ratio setting does not affect its begin time. For example, a timeline with a begin time of 5 seconds, a speed ratio of 2, and a parent timeline with a speed ratio of 1 starts after a 5 second delay, not a 2.5 second delay. For more information, see IXRTimeline::GetSpeedRatio.

.NET Framework Equivalent

System.Windows.Media.Animation.Timeline.BeginTime

Requirements

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

See Also

Reference

IXRTimeline
IXRTimeline::GetBeginTime