Timeline.SpeedRatio Propriété

Définition

Espace de noms:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Obtient ou définit le taux de progression temporelle par rapport à son parent de ce 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. La valeur par défaut est 1.

Exceptions

ArgumentException

SpeedRatio est inférieur à 0 ou n'est pas une valeur finie.

Exemples

La propriété d’une SpeedRatio chronologie contrôle son taux de progression, par rapport à son parent. Si la chronologie est une racine, elle SpeedRatio est relative à la vitesse de chronologie par défaut. L’exemple suivant montre plusieurs chronologies avec différents SpeedRatio paramètres.

<!-- 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 d’une SpeedRatio chronologie n’a pas d’effet sur son BeginTime; cette heure est relative au parent de la chronologie ou, si la chronologie est une chronologie racine, moment où l’horloge de la chronologie a été démarrée.

Si AccelerationRatio ou DecelerationRatio sont spécifiés, il s’agit SpeedRatio du ratio moyen sur la longueur naturelle de la chronologie.

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

Champ d’identificateur	SpeedRatioProperty
Propriétés de métadonnées définies sur true	Aucun