Timeline.SpeedRatio Propriété

Définition

Obtient ou définit le taux de progression temporelle par rapport à son parent de ce Timeline.Gets or sets the rate, relative to its parent, at which time progresses for this Timeline.

public:
 property double SpeedRatio { double get(); void set(double value); };
public double SpeedRatio { get; set; }
member this.SpeedRatio : double with get, set
Public Property SpeedRatio As Double

Valeur de propriété

Double

Valeur finie supérieure à 0 qui décrit le taux de progression temporelle de cette chronologie, par rapport à la vitesse du parent de la chronologie ou, s'il s'agit d'une chronologie racine, à la vitesse de chronologie par défaut.A finite value greater than 0 that describes the rate at which time progresses for this timeline, relative to the speed of the timeline's parent or, if this is a root timeline, the default timeline speed. La valeur par défaut est 1.The default value is 1.

Exceptions

SpeedRatio est inférieur à 0 ou n'est pas une valeur finie.SpeedRatio is less than 0 or is not a finite value.

Exemples

La propriété de SpeedRatio d’une chronologie contrôle son taux de progression, par rapport à son parent.A timeline's SpeedRatio property controls its rate of progress, relative to its parent. Si la chronologie est une racine, son SpeedRatio est relatif à la vitesse de chronologie par défaut.If the timeline is a root, its SpeedRatio is relative to the default timeline speed. L’exemple suivant montre plusieurs chronologies avec différents paramètres de SpeedRatio.The following example shows several timelines with different SpeedRatio settings.

<!-- This example shows how to use the SpeedRatio property 
     to make animations speed up or slow down. -->
<Page 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  WindowTitle="Speed Example">
  <StackPanel>

    <!-- The rectangles to animate. -->          
    <Rectangle Name="DefaultSpeedRectangle" 
      Width="20" Height="20" Fill="Blue"  />      
    <Rectangle Name="FasterRectangle" 
      Width="20" Height="20" Fill="Blue" />      
    <Rectangle Name="SlowerRectangle" 
      Width="20" Height="20" Fill="Blue" />
    <Rectangle Name="NestedTimelinesExampleRectangle" 
      Width="20" Height="20" Fill="Blue" />      
    
    <!-- Create a button to start the animations. -->
    <Button Margin="0,30,0,0" HorizontalAlignment="Left">Start Animations
      <Button.Triggers>
        <EventTrigger RoutedEvent="Button.Click">
          <BeginStoryboard>
            <Storyboard>

              <!-- This animation progresses at the same rate as its parent. -->
              <DoubleAnimation 
                Storyboard.TargetName="DefaultSpeedRectangle" 
                Storyboard.TargetProperty="Width" 
                From="20" To="400" Duration="0:0:2" 
                SpeedRatio="1" />

              <!-- This animation progresses twice as fast as its parent. -->
              <DoubleAnimation 
                Storyboard.TargetName="FasterRectangle" 
                Storyboard.TargetProperty="Width"
                From="20" To="400" Duration="0:0:2" 
                SpeedRatio="2"  />   

              <!-- This animation progresses at half the rate of its parent. -->
              <DoubleAnimation 
                Storyboard.TargetName="SlowerRectangle" 
                Storyboard.TargetProperty="Width" 
                From="20" To="400" Duration="0:0:2" 
                SpeedRatio="0.5"  />    
                

              <ParallelTimeline SpeedRatio="2">
                <ParallelTimeline SpeedRatio="2">
                
                  <!-- This animation progresses eight times faster
                       than normal, because of its SpeedRatio settings
                       and the SpeedRatio settings on its parents. -->
                  <DoubleAnimation 
                    Storyboard.TargetName="NestedTimelinesExampleRectangle" 
                    Storyboard.TargetProperty="Width" 
                    From="20" To="400" Duration="0:0:2" 
                    SpeedRatio="2"  />  
                </ParallelTimeline>
              </ParallelTimeline>
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger>
      </Button.Triggers>     
    </Button>
  </StackPanel>
</Page>

Remarques

Le paramètre de SpeedRatio d’une chronologie n’a aucun effet sur son BeginTime; cette heure est relative au parent de la chronologie ou, si la chronologie est une chronologie racine, moment auquel l’horloge de la chronologie a été démarrée.A timeline's SpeedRatio setting does not have an effect on its BeginTime; that time is relative to the timeline's parent or, if the timeline is a root timeline, the moment at which the timeline's clock was begun.

Si AccelerationRatio ou DecelerationRatio sont spécifiés, cette SpeedRatio est le rapport moyen sur la longueur naturelle de la chronologie.If AccelerationRatio or DecelerationRatio are specified, this SpeedRatio is the average ratio over the natural length of the timeline.

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

Champ d’identificateurIdentifier field SpeedRatioProperty
Propriétés de métadonnées définies sur trueMetadata properties set to true NoneNone

S’applique à