Timeline.Duration Property

Definition

Obtiene o establece la duración para la que se reproduce esta escala de tiempo, sin contar las repeticiones.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

Property Value

Duration

La duración simple de la escala de tiempo: la cantidad de tiempo que esta escala de tiempo tarda en completar una iteración de avance.The timeline's simple duration: the amount of time this timeline takes to complete a single forward iteration. El valor predeterminado es Automatic.The default value is Automatic.

Examples

ParallelTimeline y Storyboard son tipos de objetos TimelineGroup.ParallelTimeline and Storyboard are types of TimelineGroup objects. La duración de un TimelineGroup viene determinada por la duración de sus escalas de tiempo secundarias.The duration of a TimelineGroup is determined by the duration of its child timelines. Por ejemplo, el Storyboard siguiente se ejecutará durante seis segundos (duración de 6 segundos) porque es cuando finaliza su última escala de tiempo secundaria (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

Nota: el código se ha omitido en los ejemplos siguientes, que se proporcionan únicamente con fines 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>   
...  

Entre los ejemplos de <tipos> animaciones se incluyen DoubleAnimation, PointAnimation, ColorAnimation, etc. Si no se especifica ningún Duration para estos tipos de animaciones, se ejecutarán durante un 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 .../>  
...  

Entre los ejemplos de <tipo> AnimationUsingKeyFrames se incluyen DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFrames, etc. Si no se especifica ningún Duration para estos tipos de animaciones, se ejecutarán hasta que finalicen todos los fotogramas clave.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>   
...  

Remarks

La duración simple de una escala de tiempo constituye el tiempo de una sola iteración de avance frente al tiempo total de reproducción, que incluye las repeticiones.A timeline's simple duration constitutes the time for a single forward iteration versus the total play time, which includes repetitions.

Comportamiento de duración predeterminadoDefault Duration Behavior

El comportamiento de una estructura de Duration con un valor de Automatic depende del tipo de escala de tiempo:The behavior of a Duration structure with a value of Automatic depends on the type of timeline:

MarcoTimeline ComportamientoBehavior
Timeline Sin determinar (Timeline es abstracta)Undetermined (Timeline is abstract)
ParallelTimeline,ParallelTimeline,

Storyboard,Storyboard,

TimelineGroup
Se expande para ajustarse a las escalas de tiempo secundariasExpands to fit child timelines
<tipo> Animación (conocido como animaciones "from/to/by" o "Basic")<Type>Animation (Known as a "From/To/By" or "basic" animations) 1 segundo1 second
<tipo> AnimationUsingKeyFrames (conocido como animaciones de fotogramas clave)<Type>AnimationUsingKeyFrames (Known as key frame animations) Suma de todos los valores de KeyTime de fotogramas claveSum of all key frame KeyTime values

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field DurationProperty
Propiedades de metadatos establecidas en trueMetadata properties set to true NoneNone

Applies to

See also