Timeline.Duration Property

Definition

Получает или задает продолжительность воспроизведения шкалы времени без учета повторов.Gets or sets the length of time for which this timeline plays, not counting repetitions.

public:
 property System::Windows::Duration Duration { System::Windows::Duration get(); void set(System::Windows::Duration value); };
public System.Windows.Duration Duration { get; set; }
member this.Duration : System.Windows.Duration with get, set
Public Property Duration As Duration

Property Value

Duration

Простая длительность шкалы времени: время выполнения шкалой времени отдельной прямой итерации.The timeline's simple duration: the amount of time this timeline takes to complete a single forward iteration. Значение по умолчанию — Automatic.The default value is Automatic.

Examples

ParallelTimeline и Storyboard являются типами TimelineGroup объектов.ParallelTimeline and Storyboard are types of TimelineGroup objects. Длительность TimelineGroup определяется длительностью ее дочерних временных шкал.The duration of a TimelineGroup is determined by the duration of its child timelines. Например, Storyboard ниже будет выполняться в течение шести секунд (продолжительность 6 секунд), так как это происходит после завершения последней дочерней временной шкалы (DoubleAnimation).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.

[xaml][xaml]

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

К примерам типов<> анимации относятся DoubleAnimation, PointAnimation, ColorAnimationи т. д. Если для таких типов анимации не задано Duration, они будут выполняться в течение одной секунды.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][xaml]

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

Примеры типов<> AnimationUsingKeyFrames включают DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFramesи т. д. Если для этих типов анимации не задано Duration, они будут выполняться до завершения всех ключевых кадров.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][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>   
...  

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

Поведение структуры Duration со значением Automatic зависит от типа временной шкалы:The behavior of a Duration structure with a value of Automatic depends on the type of timeline:

ГрафикаTimeline ПоведениеBehavior
Timeline Не определено (Timeline является абстрактным)Undetermined (Timeline is abstract)
ParallelTimeline,ParallelTimeline,

Storyboard,Storyboard,

TimelineGroup
Разворачивается в соответствии с дочерними временными шкаламиExpands to fit child timelines
Анимация типа<> (известная как "From/To/By" или "Basic" анимация)<Type>Animation (Known as a "From/To/By" or "basic" animations) 1 с1 second
тип<> AnimationUsingKeyFrames (известный как анимация по ключевым кадрам)<Type>AnimationUsingKeyFrames (Known as key frame animations) Сумма всех значений KeyTime ключевых кадровSum of all key frame KeyTime values

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field DurationProperty
Для свойств метаданных задано значение trueMetadata properties set to true NoneNone

Applies to

See also