Timeline.SpeedRatio Propriedade

Definição

Obtém ou define a taxa, em relação ao pai, na qual o tempo progride para isso 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

Valor da propriedade

Um valor finito maior que 0 que descreve a taxa na qual o tempo progride para esta linha do tempo, em relação à velocidade do pai da linha do tempo ou, se esta for uma linha do tempo raiz, a velocidade padrão da linha do tempo.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. O valor padrão é 1.The default value is 1.

Exceções

SpeedRatio é menor que 0 ou não é um valor finito.SpeedRatio is less than 0 or is not a finite value.

Exemplos

A SpeedRatio propriedade de uma linha do tempo controla sua taxa de progresso, em relação ao seu pai.A timeline's SpeedRatio property controls its rate of progress, relative to its parent. Se a linha do tempo for uma raiz SpeedRatio , ela será relativa à velocidade padrão da linha do tempo.If the timeline is a root, its SpeedRatio is relative to the default timeline speed. O exemplo a seguir mostra várias linhas do tempo com SpeedRatio configurações diferentes.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>

Comentários

A configuração de SpeedRatio uma linha do tempo não tem um efeito BeginTimeem seu; esse tempo é relativo ao pai da linha do tempo ou, se a linha do tempo for uma linha do tempo raiz, o momento em que o relógio do cronograma foi iniciado.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.

Se AccelerationRatio SpeedRatio ou DecelerationRatio for especificado, esta é a taxa média em relação ao comprimento natural da linha do tempo.If AccelerationRatio or DecelerationRatio are specified, this SpeedRatio is the average ratio over the natural length of the timeline.

Informações da propriedade de dependênciaDependency Property Information

Campo de identificadorIdentifier field SpeedRatioProperty
Propriedades de metadados definidas comotrueMetadata properties set to true NenhumNone

Aplica-se a