Timeline.Duration Propriedade

Definição

Obtém ou define o período para o qual essa linha do tempo é reproduzida, sem contar repetições.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

Valor da propriedade

A duração simples da linha do tempo: a quantidade de tempo que essa linha do tempo leva para concluir uma única iteração de encaminhamento.The timeline's simple duration: the amount of time this timeline takes to complete a single forward iteration. O valor padrão é Automatic.The default value is Automatic.

Exemplos

ParallelTimelinee Storyboard são tipos de TimelineGroup objetos.ParallelTimeline and Storyboard are types of TimelineGroup objects. A duração de um TimelineGroup é determinada pela duração de suas linhas do tempo filho.The duration of a TimelineGroup is determined by the duration of its child timelines. Por exemplo, a Storyboard seguir será executado por seis segundos (duração de 6 segundos) porque é quando sua última linha do tempo filhoDoubleAnimation() termina.For example, the Storyboard below will run for six seconds (duration of 6 seconds) because that is when its last child Timeline (DoubleAnimation) ends.

Observação

Observação: o código foi omitido dos exemplos a seguir, que são fornecidos apenas para fins ilustrativos.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>   
...  

Exemplos de < tipos> DoubleAnimation animaçõesincluemPointAnimation,, ,etc.ColorAnimation Se nenhum Duration for especificado para esses tipos de animação, eles serão executados por um segundo.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 .../>  
...  

Exemplos do < tipo> AnimationUsingKeyFrames incluem DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFrames, etc. Se nenhum Duration for especificado para esses tipos de animações, eles serão executados até que todos os quadros-chave sejam concluídos.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>   
...  

Comentários

A duração simples de uma linha do tempo constitui o tempo para uma única iteração progressiva em relação ao tempo total de execução, que inclui repetições.A timeline's simple duration constitutes the time for a single forward iteration versus the total play time, which includes repetitions.

Comportamento da duração padrãoDefault Duration Behavior

O comportamento de uma Duration estrutura com um valor de Automatic depende do tipo de linha do tempo:The behavior of a Duration structure with a value of Automatic depends on the type of timeline:

Linha do tempoTimeline ComportamentoBehavior
Timeline Indeterminado (Timeline é abstrato)Undetermined (Timeline is abstract)
ParallelTimeline,ParallelTimeline,

Storyboard,Storyboard,

TimelineGroup
Expande para ajustar as linhas do tempo filhoExpands to fit child timelines
<Digite> animação (conhecida como "de/para/por" ou animações "básicas")<Type>Animation (Known as a "From/To/By" or "basic" animations) 1 segundo1 second
<Digite> AnimationUsingKeyFrames (conhecido como animações de quadro chave)<Type>AnimationUsingKeyFrames (Known as key frame animations) Soma de todos os valores KeyTime de quadro chaveSum of all key frame KeyTime values

Informações da propriedade de dependênciaDependency Property Information

Campo de identificadorIdentifier field DurationProperty
Propriedades de metadados definidas comotrueMetadata properties set to true NenhumNone

Aplica-se a

Veja também