Timeline.Duration Propriedade

Definição

Espaço de Nomes:
System.Windows.Media.Animation
Assemblagem:
PresentationCore.dll

Obtém ou define o tempo em que esta linha temporal é 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 de Propriedade

Duration

A duração simples da linha temporal: o tempo que esta linha temporal demora a completar uma única iteração em frente. O valor predefinido é Automatic.

Exemplos

ParallelTimeline e Storyboard são tipos de TimelineGroup objetos. A duração de a TimelineGroup é determinada pela duração das suas linhas temporais filhas. Por exemplo, a Storyboard linha temporal abaixo dura seis segundos (duração de 6 segundos) porque é quando termina a sua última linha temporal filha (DoubleAnimation).

Note

O código foi omitido dos exemplos seguintes, que são fornecidos apenas para fins ilustrativos.

...
  <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 este tipo de animações, elas funcionam durante um segundo.

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

Exemplos de <Type>AnimationUsingKeyFrames incluem DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFrames, etc. Se Duration não for especificado para este tipo de animações, estas vão correr até que todos os keyframes estejam concluídos.

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

Observações

A duração simples de uma linha temporal constitui o tempo para uma única iteração em frente contra o tempo total de jogo, que inclui repetições.

Comportamento de Duração Padrão

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

Linha cronológica Comportamento
Timeline Indeterminado (Timeline é abstrato)
ParallelTimeline,

Storyboard,

TimelineGroup		 Expande-se para se ajustar às linhas temporais das crianças
< Tipo>Animação (conhecida como animações "From/To/By" ou "básicas") 1 segundo
< Tipo>AnimationUsingKeyFrames (Conhecida como animações keyframes) Soma de todos os valores dos keyframes KeyTime

Informação de Propriedade de Dependência

Iteme Value
Campo identificador DurationProperty
Propriedades dos metadados definidas como true None

Aplica-se a

Ver também