Timeline.SpeedRatio Eigenschaft

Definition

Ruft die Geschwindigkeit ab, mit der die Zeit für diese Timeline, relativ zum übergeordneten Element, verläuft, oder legt diese fest.

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

Eigenschaftswert

Double

Ein endlicher Wert größer als 0, der die Geschwindigkeit beschriebt, mit der die Zeit für diese Zeitachse verläuft, relativ zur Geschwindigkeit des übergeordneten Elements der Zeitachse oder, wenn es sich um eine Stammzeitachse handelt, die Standardgeschwindigkeit der Zeitachse. Der Standardwert ist 1.

Ausnahmen

SpeedRatio ist kleiner als 0 oder kein endlicher Wert.

Beispiele

Die Eigenschaft einer Zeitachse steuert die Geschwindigkeit des Fortschritts SpeedRatio relativ zum übergeordneten Element. Wenn die Zeitachse ein Stamm ist, ist dies SpeedRatio relativ zur Standardzeitachsengeschwindigkeit. Das folgende Beispiel zeigt mehrere Zeitachsen mit unterschiedlichen SpeedRatio Einstellungen.

<!-- 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>

Hinweise

Die Einstellung einer SpeedRatio Zeitachse hat keine Auswirkung auf BeginTimeseine Einstellung. Diese Zeit ist relativ zum übergeordneten Element der Zeitachse oder, wenn die Zeitachse eine Stammzeitachse ist, der Moment, zu dem die Zeitachse begonnen wurde.

Wenn AccelerationRatio oder DecelerationRatio angegeben wird, ist dies SpeedRatio das durchschnittliche Verhältnis über die natürliche Länge der Zeitachse.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld SpeedRatioProperty
Metadateneigenschaften auf true festgelegt Keine

Gilt für