Freigeben über


Timeline.SpeedRatio Eigenschaft

Definition

Dient zum Abrufen oder Festlegen der Rate relativ zum übergeordneten Element, zu dem der Zeitpunkt, zu Timelinedem dies fortschreitet.

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

Ein endlicher Wert größer als 0, der die Rate beschreibt, zu der der Zeitverlauf für diese Zeitachse erfolgt, relativ zur Geschwindigkeit des übergeordneten Elements der Zeitachse oder, wenn dies eine Stammzeitachse ist, die Standardzeitachsengeschwindigkeit. Der Standardwert ist 1.

Ausnahmen

SpeedRatio ist kleiner als 0 oder ist kein endlicher Wert.

Beispiele

Die Eigenschaft einer Zeitachse SpeedRatio steuert die Fortschrittsrate relativ zum übergeordneten Element. Wenn die Zeitachse ein Stamm ist, ist sie 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 Auswirkungen auf die BeginTimeZeit. 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, ist dies SpeedRatio das durchschnittliche Verhältnis über die natürliche Länge der Zeitachse.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld SpeedRatioProperty
Auf Metadateneigenschaften festgelegt true Nichts

Gilt für: