Timeline.BeginTime Propriété

Définition

Obtient ou définit l'heure à laquelle ce Timeline doit commencer.Gets or sets the time at which this Timeline should begin.

public:
 property Nullable<TimeSpan> BeginTime { Nullable<TimeSpan> get(); void set(Nullable<TimeSpan> value); };
public Nullable<TimeSpan> BeginTime { get; set; }
member this.BeginTime : Nullable<TimeSpan> with get, set
Public Property BeginTime As Nullable(Of TimeSpan)

Valeur de propriété

Heure à laquelle ce Timeline doit commencer, par rapport au BeginTime de son parent.The time at which this Timeline should begin, relative to its parent's BeginTime. Si cette chronologie est une chronologie racine, l'heure est relative à son heure de début interactive (à savoir le moment auquel la chronologie a été déclenchée).If this timeline is a root timeline, the time is relative to its interactive begin time (the moment at which the timeline was triggered). Cette valeur peut être positive, négative ou null ; une valeur null signifie que la chronologie ne s'accomplit jamais.This value may be positive, negative, or null; a null value means the timeline never plays. La valeur par défaut est 0.The default value is zero.

Exemples

La propriété d' BeginTime une chronologie détermine le début de la période active d’une chronologie.A timeline's BeginTime property determines the beginning of a timeline's active period. Si la chronologie a une chronologie parente, BeginTime la propriété détermine la durée de démarrage de la chronologie après le démarrage de son parent.If the timeline has a parent timeline, the BeginTime property determines how long it takes the timeline to start after its parent starts. Si la chronologie est une chronologie racine (un Storyboard, par exemple), la BeginTime propriété détermine le temps nécessaire à la chronologie pour commencer à s’exécuter après qu’elle a été déclenchée.If the timeline is a root timeline (a Storyboard, for example), the BeginTime property determines how long the timeline takes to start playing after it is triggered.

L’exemple suivant montre plusieurs chronologies différentes avec des BeginTime paramètres différents.The following example shows several different timelines with different BeginTime settings.

<!-- This example shows how the BeginTime property determines when a timeline starts.
     Several rectangles are animated by DoubleAnimations with identical 
     durations and target values, but with different
     BeginTime settings. -->
     
<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  WindowTitle="BeginTime Example">
  <StackPanel Margin="20">

    <!-- The rectangles to animate. -->
    <Rectangle Name="DefaultBeginTimeRectangle" 
      Width="20" Height="20" Fill="Blue"  />
      
    <Rectangle Name="DelayedBeginTimeRectangle" 
      Width="20" Height="20" Fill="Blue"  />
    
    <Rectangle Name="DelayedAnimationWithDelayedParentRectangle" 
      Width="20" Height="20" Fill="Blue"  /> 

    <Rectangle Name="NegativeBeginTimeExampleRectangle" 
      Width="20" Height="20" Fill="Blue"  />            
    
    <!-- Create a button to start the animations. -->
    <Button Margin="20" Content="Start Animations">
      <Button.Triggers>
        <EventTrigger RoutedEvent="Button.Click">
          <BeginStoryboard>
            <Storyboard>

              <!-- This animation starts as soon as the button is clicked, because it
                   has a BeginTime of 0. -->
              <DoubleAnimation 
                Storyboard.TargetName="DefaultBeginTimeRectangle" 
                Storyboard.TargetProperty="Width"
                BeginTime="0:0:0" From="100" To="600" Duration="0:0:5"  /> 

              <!-- This animation starts 5 seconds after the button is clicked. -->
              <DoubleAnimation 
                Storyboard.TargetName="DelayedBeginTimeRectangle" 
                Storyboard.TargetProperty="Width"  
                BeginTime="0:0:5" From="100" To="600" Duration="0:0:5" />
                
              <ParallelTimeline BeginTime="0:0:5">  

              <!-- This animation starts 10 seconds after the button is clicked, 
                   because its parent has a BeginTime of 5 seconds and it has
                   a BeginTime of 5 seconds: 5 + 5 = 10.  -->              
                <DoubleAnimation  
                  Storyboard.TargetName="DelayedAnimationWithDelayedParentRectangle" 
                  Storyboard.TargetProperty="Width" 
                  BeginTime="0:0:5" From="100" To="600" Duration="0:0:5"  />
              </ParallelTimeline>
              
              <!-- This animation starts as soon as the button is clicked, but
                   it animates from 350 to 600 instead of from 100 to 600 
                   because of its negative BeginTime. The negative BeginTime
                   setting advances the animation, so that it behaves as though
                   it had already been playing for 2.5 seconds as soon as it is
                   started. -->
              <DoubleAnimation 
                Storyboard.TargetName="NegativeBeginTimeExampleRectangle" 
                Storyboard.TargetProperty="Width"  
                BeginTime="-0:0:2.5" From="100" To="600" Duration="0:0:5" />              
              
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger>
      </Button.Triggers>      
    </Button>
    
    <!-- This example demonstrates how the BeginTime property works on a root timeline. -->
    <Rectangle Name="RootTimelineWithDelayedBeginTimeRectangle"
      Width="20" Height="20" Fill="Blue" >
      <Rectangle.Triggers>
        <EventTrigger RoutedEvent="Rectangle.MouseLeftButtonDown">
          <BeginStoryboard>
            <Storyboard BeginTime="0:0:5">
            
              <!-- This animation starts 5 seconds after the left mouse button
                   is pressed, because its parent storyboard (a root timeline)
                   has a BeginTime of 5 seconds. -->
              <DoubleAnimation 
                Storyboard.TargetName="RootTimelineWithDelayedBeginTimeRectangle" 
                Storyboard.TargetProperty="Width"
                BeginTime="0:0:0" From="100" To="600" Duration="0:0:2" />
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger>
      </Rectangle.Triggers>
    </Rectangle>    
  </StackPanel>
</Page>

Remarques

La BeginTime propriété est utile pour créer des chronologies qui s’exécutent dans une séquence: BeginTime en accroissant le des chronologies consécutives qui partagent le même parent, vous pouvez échelonner leurs temps de lecture.The BeginTime property is useful for creating timelines that play in a sequence: by increasing the BeginTime of successive timelines that share the same parent, you can stagger their play times.

Valeurs négativesNegative Values

Une valeur BeginTime négative force un Timeline à se comporter comme s’il avait démarré à un moment donné dans le passé.A negative BeginTime value causes a Timeline to behave as though it started at some time in the past. Par exemple, un Timeline avec une BeginTime valeur négative de 2,5 secondes et Duration une valeur de 5 secondes s’affichera comme étant à moitié terminé au démarrage.For example, a Timeline with a BeginTime of negative 2.5 seconds and a Duration of 5 seconds will appear to be half-way finished when it starts.

BeginTime et SpeedRatioBeginTime and SpeedRatio

L’heure décrite par la BeginTime propriété est mesurée dans le temps parent’s de la chronologie.The time described by the BeginTime property is measured in the timeline's parent's time. Par exemple, une chronologie avec un BeginTime de 5 dont le parent a SpeedRatio un de 2 démarre en fait après 2,5 secondes.For example, a timeline with a BeginTime of 5 whose parent has a SpeedRatio of 2 actually starts after 2.5 seconds.

Le propre SpeedRatio paramètre d’une chronologie n’affecte pas BeginTimeson.A timeline's own SpeedRatio setting does not affect its BeginTime. Par exemple, une chronologie avec une BeginTime de 5 secondes, une SpeedRatio de 2 et une chronologie parente avec un SpeedRatio de 1 démarre après 5 secondes, et non pas 2,5.For example, a timeline with a BeginTime of 5 seconds, a SpeedRatio of 2, and a parent timeline with a SpeedRatio of 1 starts after 5 seconds, not 2.5.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field BeginTimeProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true Aucun.None

Utilisation d'attributs XAMLXAML Attribute Usage

<objet = "[-] [jours.] BeginTime heures:minutes:secondes[. fractionalSeconds] "/><object BeginTime="[-][days.]hours:minutes:seconds[.fractionalSeconds]"/>

ou-or-

<objet = "[-] [jours.] BeginTime heures:minutes"/><object BeginTime="[-][days.]hours:minutes"/>

- ou --or-

<object BeginTime="[-]days"/><object BeginTime="[-]days"/>

- ou --or-

<objet = "{x:null Markup Extension}"/> BeginTime<object BeginTime="{x:Null Markup Extension}"/>

Valeurs XAMLXAML Values

Les éléments entre crochets ([ et ]) sont facultatifs.Items in square brackets ([ and ]) are optional.

précédantdays
System.Int32

Valeur supérieure ou égale à 0 qui décrit le nombre de jours sur lequel s’étend cette heure de début.A value greater than or equal to 0 that describes the number of days spanned by this begin time.

travailléhours
System.Int32

Valeur comprise entre 0 et 23 qui représente le nombre d’heures couvertes par cette heure de début.A value between 0 and 23 that represents the number of hours spanned by this begin time.

minutesminutes
System.Int32

Valeur comprise entre 0 et 59 qui représente le nombre de minutes sur lesquelles s’étend cette heure de début.A value between 0 and 59 that represents the number of minutes spanned by this begin time.

duréeseconds
System.Int32

Valeur comprise entre 0 et 59 qui représente le nombre de secondes sur lesquelles s’étend cette heure de début.A value between 0 and 59 that represents the number of seconds spanned by this begin time.

fractionalSecondsfractionalSeconds
System.Int32

Valeur composée de 1 à 7 chiffres qui représente des fractions de seconde.A value consisting of 1 to 7 digits that represents fractional seconds.

Pour obtenir la TimeSpan syntaxe complète, consultez la section Notes de Parse la page.For the complete TimeSpan syntax, see the Remarks section of the Parse page.

S’applique à

Voir aussi