Timeline.Duration Свойство

Определение

Пространство имен:

System.Windows.Media.Animation

Сборка:

PresentationCore.dll

Возвращает или задает продолжительность времени, в течение которого эта временная шкала воспроизводится, не подсчитывая повторения.

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

Значение свойства

Duration

Простая длительность временной шкалы: время, затраченное на выполнение одной итерации вперед. Значение по умолчанию — Automatic.

Примеры

ParallelTimeline и Storyboard являются типами TimelineGroup объектов. Длительность интервала TimelineGroup определяется длительностью его дочерних временных шкал. Например, приведенные Storyboard ниже будут работать в течение шести секунд (длительность 6 секунд), так как это происходит при завершении последней дочерней временной шкалы (DoubleAnimation).

Note

Код был опущен из следующих примеров, которые предоставляются только для иллюстрирующих целеустремленных.

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

Примеры анимации <типов>: DoubleAnimation, PointAnimationи ColorAnimationт. д. Если для этих типов анимаций не Duration указано, они будут выполняться в течение одной секунды.

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

Примеры анимации < typeUsingKeyFrames> включают DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFramesи т. д. Если для этих типов анимаций не Duration указано, они будут выполняться до завершения всех ключевых кадров.

...
  <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>
...

Комментарии

Простая длительность временной шкалы составляет время для одной итерации вперед и общее время воспроизведения, которое включает повторения.

Поведение длительности по умолчанию

Поведение Duration структуры со значением Automatic зависит от типа временной шкалы:

Временная шкала	Поведение
Timeline	Неопределенный (Timeline абстрактный)
ParallelTimeline, Storyboard, TimelineGroup	Расширяется, чтобы соответствовать дочерним временным шкалам
< Тип>Анимация (известная как анимация from/To/By или basic)	1 секунда
< Тип>AnimationUsingKeyFrames (известный как анимация ключевых кадров)	Сумма всех значений ключевых кадров KeyTime

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

Элемент	Ценность
Поле идентификатора	DurationProperty
Свойства метаданных, равные свойству true	None

См. также раздел

• SkipToFill()
• Stop()