Timeline.Duration Propriedade

Definição

Namespace:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Obtém ou define o período para o qual essa linha do tempo é reproduzida, sem contar repetições.

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

Duration

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. O valor padrão é Automatic.

Exemplos

ParallelTimeline e Storyboard são tipos de TimelineGroup objetos. A duração de um TimelineGroup é determinada pela duração de suas linhas do tempo filho. Por exemplo, o Storyboard abaixo será executado por seis segundos (duração de 6 segundos) porque é quando sua última Linha do Tempo filho (DoubleAnimation) termina.

Observação

Observação: o código foi omitido dos exemplos a seguir, que são fornecidos apenas para fins ilustrativos.

[xaml]

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

Exemplos de animações de <tipo>incluem DoubleAnimation, PointAnimation, ColorAnimation, etc. Se não Duration for especificado para esses tipos de animações, eles serão executados por um segundo.

[xaml]

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

Exemplos de Animaçãode < TipoUsingKeyFrames >incluem DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFramesetc. Se não Duration for especificado para esses tipos de animações, eles serão executados até que todos os quadros-chave sejam concluídos.

[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 iteração de encaminhamento única versus o tempo total de reprodução, que inclui repetições.

Comportamento de duração padrão

O comportamento de uma Duration estrutura com um valor de Automatic depende do tipo de linha do tempo:

Linha do tempo	Comportamento
Timeline	Indeterminado (Timeline é abstrato)
ParallelTimeline, Storyboard, TimelineGroup	Expande para ajustar linhas do tempo filho
<Tipo> Animação (conhecida como animações "De/para/Por" ou "básicas")	1 segundo
<Tipo> AnimationUsingKeyFrames (conhecido como animações de quadro-chave)	Soma de todos os valores de quadro-chave KeyTime

Informações da propriedade de dependência

Campo Identificador	DurationProperty
Propriedades de metadados definidas como true	Nenhum

Confira também

• SkipToFill()
• Stop()