Timeline.SpeedRatio Timeline.SpeedRatio Timeline.SpeedRatio Timeline.SpeedRatio Property

Definition

Ruft die Geschwindigkeit ab, mit der die Zeit für diese Timeline, relativ zum übergeordneten Element, verläuft, oder legt diese fest.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

Eigenschaftswert

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.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. Der Standardwert ist 1.The default value is 1.

Ausnahmen

SpeedRatio ist kleiner als 0 oder kein endlicher Wert.SpeedRatio is less than 0 or is not a finite value.

Beispiele

Einer Zeitachse SpeedRatio -Eigenschaft steuert die Rate der ausgeführt wird, relativ zum übergeordneten Element.A timeline's SpeedRatio property controls its rate of progress, relative to its parent. Wenn die Zeitachse eine Stammzertifizierungsstelle, ist die SpeedRatio ist relativ zur Geschwindigkeit Standard-Zeitachse.If the timeline is a root, its SpeedRatio is relative to the default timeline speed. Das folgende Beispiel zeigt mehrere Zeitpläne mit unterschiedlichen SpeedRatio Einstellungen.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>

Hinweise

Einer Zeitachse SpeedRatio Einstellung keine Auswirkungen auf die BeginTime: das wird relativ zum übergeordneten Element der Zeitachse oder, wenn die Zeitachse eine Stammzeitachse handelt, den Moment ist mit der Uhr der Zeitachse gestartet wurde.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.

Wenn AccelerationRatio oder DecelerationRatio angegeben wird, ist dies SpeedRatio ist das durchschnittliche Verhältnis auf die natürliche Dauer der Zeitachse.If AccelerationRatio or DecelerationRatio are specified, this SpeedRatio is the average ratio over the natural length of the timeline.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field SpeedRatioProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true NoneNone

Gilt für: