Timeline.SpeedRatio Свойство

Определение

Пространство имен:

System.Windows.Media.Animation

Сборка:

PresentationCore.dll

Получает или задает скорость течения времени этого объекта 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

Значение свойства

Double

Конечное значение больше нуля 0, определяющее скорость течения времени для шкалы времени относительно скорости родительского объекта этой шкалы времени или (если речь идет о корневой шкале времени), скорость шкалы времени по умолчанию. Значение по умолчанию — 1.

Исключения

ArgumentException

Параметр SpeedRatio меньше 0 или не является конечным значением.

Примеры

Свойство временной шкалы SpeedRatio управляет скоростью хода выполнения относительно родительского элемента. Если временная шкала является корневым, она SpeedRatio соответствует скорости временной шкалы по умолчанию. В следующем примере показано несколько временных шкал с различными SpeedRatio параметрами.

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

Комментарии

Параметр временной шкалы SpeedRatio не влияет на его BeginTimeзначение; это время относительно родительского элемента временной шкалы или, если временная шкала является корневой временной шкалой, момент начала часов временной шкалы.

Если AccelerationRatio или DecelerationRatio указано, это SpeedRatio среднее соотношение по естественной длине временной шкалы.

Сведения о свойстве зависимостей

Поле идентификатора	SpeedRatioProperty
Для свойств метаданных задано значение true	Нет