This topic has not yet been rated - Rate this topic

Timeline.Duration Property

.NET Framework 4.5

Gets or sets the length of time for which this timeline plays, not counting repetitions.

Namespace: System.Windows.Media.Animation
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

C++

public Duration Duration { get; set; }

XAML Attribute Usage

<object Duration="Duration" .../>

Property Value

Type: System.Windows.Duration
The timeline's simple duration: the amount of time this timeline takes to complete a single forward iteration. The default value is Automatic.

Dependency Property Information

Identifier field	DurationProperty
Metadata properties set to true	None

Remarks

A timeline's simple duration constitutes the time for a single forward iteration versus the total play time, which includes repetitions.

Default Duration Behavior

The behavior of a Duration structure with a value of Automatic depends on the type of timeline:

Timeline	Behavior
Timeline	Undetermined (Timeline is abstract)
ParallelTimeline, Storyboard, TimelineGroup	Expands to fit child timelines
<Type>Animation (Known as a "From/To/By" or "basic" animations)	1 second
<Type>AnimationUsingKeyFrames (Known as key frame animations)	Sum of all key frame KeyTime values

Examples

ParallelTimeline and Storyboard are types of TimelineGroup objects. The duration of a TimelineGroup is determined by the duration of its child timelines. For example, the Storyboard below will run for six seconds (duration of 6 seconds) because that is when its last child Timeline (DoubleAnimation) ends.

Note
Note: code has been omitted from the following examples, which are provided for illustrative purposed only.

Note

Note: code has been omitted from the following examples, which are provided for illustrative purposed only.

[xaml]

...
  <Storyboard>
    <DoubleAnimation Duration="0:0:2" …/>
    <DoubleAnimation Duration="0:0:4" BeginTime="0:0:2" …/>
  </Storyboard> 
...

Examples of <Type>Animations include DoubleAnimation, PointAnimation, ColorAnimation, etc. If no Duration is specified for these types of animations, they will run for one second.

[xaml]

...
  <!-- With no Duration specified, this animation will run for 
       one second -->
  <DoubleAnimation .../>
...

Examples of <Type>AnimationUsingKeyFrames include DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFrames, etc. If no Duration is specified for these types of animations they will run until all key frames are finished.

[xaml]

...
  <Storyboard>

    <!-- This key frame animation will end at 4.5 seconds
         Because that is when its last KeyFrame KeyTime ends. -->
    <DoubleAnimationUsingKeyFrames ...>
      <LinearDoubleKeyFrame ... KeyTime="0:0:3" />
      <DiscreteDoubleKeyFrame ... KeyTime="0:0:3.5" />
      <DiscreteDoubleKeyFrame ... KeyTime="0:0:4" />
      <DiscreteDoubleKeyFrame ... KeyTime="0:0:4.5" />
    </DoubleAnimationUsingKeyFrames>
  </Storyboard> 
...

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Timeline Class

System.Windows.Media.Animation Namespace

SkipToFill

Stop

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)