Timeline.Duration Свойство

Определение

Получает или задает продолжительность воспроизведения шкалы времени без учета повторов.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

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

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

Примеры

ParallelTimelineтипы и Storyboard являются типами объектов.TimelineGroupParallelTimeline 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: 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 этих типов анимации не задано значение No, они будут выполняться в течение одной секунды.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>   
...  

Комментарии

Простая длительность временной шкалы составляет время для одной прямой итерации относительно общего времени воспроизведения, включая повторения.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 НетNone

Применяется к

Дополнительно