Timeline.Duration Timeline.Duration Timeline.Duration Timeline.Duration Property

Определение

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

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

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