Timeline.Duration Propriété

Définition

Obtient ou définit la durée de cette chronologie, sans prendre en compte les répétitions.

C#
public System.Windows.Duration Duration { get; set; }

Valeur de propriété

Durée simple de la chronologie : durée nécessaire à cette chronologie pour accomplir une seule itération en avant. La valeur par défaut est Automatic.

Exemples

ParallelTimeline et Storyboard sont des types d’objets TimelineGroup . La durée d’un TimelineGroup est déterminée par la durée de ses chronologies enfants. Par exemple, le Storyboard fichier ci-dessous s’exécute pendant six secondes (durée de 6 secondes), car c’est à ce moment que sa dernière chronologie enfant (DoubleAnimation) se termine.

Note

Remarque : le code a été omis dans les exemples suivants, qui sont fournis à titre indicatif uniquement.

[xaml]

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

Les animations de <type>incluent DoubleAnimation, PointAnimation, ColorAnimation, etc. Si aucune Duration n’est spécifiée pour ces types d’animations, elles s’exécutent pendant une seconde.

[xaml]

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

Les exemples de <Type>AnimationUsingKeyFrames incluent DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFrames, etc. Si aucune Duration n’est spécifiée pour ces types d’animations, elles s’exécutent jusqu’à ce que toutes les images clés soient terminées.

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

Remarques

La durée simple d’une chronologie constitue le temps d’une seule itération avancée par rapport au temps de lecture total, qui comprend les répétitions.

Comportement de durée par défaut

Le comportement d’une Duration structure avec une valeur de Automatic dépend du type de chronologie :

Durée Comportement
Timeline Non déterminé (Timeline est abstrait)
ParallelTimeline,

Storyboard,

TimelineGroup
S’étend pour s’adapter aux chronologies enfants
< Type> Animation (appelées animations « De/À/Par » ou « de base ») 1 seconde
< Type> AnimationUsingKeyFrames (appelées animations d’images clés) Somme de toutes les valeurs de trame KeyTime clé

Informations sur les propriétés de dépendance

Champ Identificateur DurationProperty
Propriétés de métadonnées définies sur true Aucun

S’applique à

Produit Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Voir aussi