DoubleAnimation Класс

Определение

public ref class DoubleAnimation sealed : Timeline

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DoubleAnimation final : Timeline

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DoubleAnimation : Timeline

Public NotInheritable Class DoubleAnimation
Inherits Timeline

<DoubleAnimation />

Наследование

Object Platform::Object IInspectable DependencyObject Timeline DoubleAnimation

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Примеры

В следующем примере показано, как использовать DoubleAnimation для создания прямоугольника, который исчезает после загрузки.

<StackPanel>
    <StackPanel.Resources>
        <Storyboard x:Name="myStoryboard">
            <DoubleAnimation
          Storyboard.TargetName="MyAnimatedRectangle"
          Storyboard.TargetProperty="Opacity"
          From="1.0" To="0.0" Duration="0:0:3"
          AutoReverse="True" RepeatBehavior="Forever" />
        </Storyboard>
    </StackPanel.Resources>

    <Rectangle Loaded="Start_Animation" x:Name="MyAnimatedRectangle"
     Width="100" Height="100" Fill="Blue" />

</StackPanel>

// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
    myStoryboard.Begin();
}

<Canvas>
    <Canvas.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Animate the TranslateTransform's X property
           from 0 to 350, then 50, then 200 over 10 seconds. -->
            <DoubleAnimationUsingKeyFrames
       Storyboard.TargetName="MyAnimatedTranslateTransform"
       Storyboard.TargetProperty="X"
       Duration="0:0:10" EnableDependentAnimation="True">

                <!-- Using a LinearDoubleKeyFrame, the rectangle moves 
           steadily from its starting position to 500 over 
           the first 3 seconds.  -->
                <LinearDoubleKeyFrame Value="500" KeyTime="0:0:3" />

                <!-- Using a DiscreteDoubleKeyFrame, the rectangle suddenly 
           appears at 400 after the fourth second of the animation. -->
                <DiscreteDoubleKeyFrame Value="400" KeyTime="0:0:4" />

                <!-- Using a SplineDoubleKeyFrame, the rectangle moves 
           back to its starting point. The animation starts out slowly at 
           first and then speeds up. This KeyFrame ends after the 6th
           second. -->
                <SplineDoubleKeyFrame KeySpline="0.6,0.0 0.9,0.00" Value="0" KeyTime="0:0:6" />

            </DoubleAnimationUsingKeyFrames>
        </Storyboard>
    </Canvas.Resources>

    <Rectangle PointerPressed="Pointer_Clicked" Fill="Blue"
 Width="50" Height="50">
        <Rectangle.RenderTransform>
            <TranslateTransform x:Name="MyAnimatedTranslateTransform" />
        </Rectangle.RenderTransform>
    </Rectangle>

</Canvas>

// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
    myStoryboard.Begin();
}

Комментарии

Используйте DoubleAnimation, чтобы анимировать значение свойства любого свойства зависимости, которое имеет тип Double.

Иногда необходимо использовать непрямое свойство, предназначенное для назначения под свойств другого объекта, которое является значением свойства в целевом объекте. Например, чтобы анимировать компонент X объекта RenderTransformuiElement, необходимо ссылаться на некоторые из промежуточных значений свойств объекта, пока последний шаг в пути косвенного свойства действительно является двойным значением, как и в случае с TranslateTransform.X. Правильная строка, используемая для Storyboard.TargetProperty в этом примере: "(UIElement.RenderTransform). (TranslateTransform.X)". Дополнительные сведения о непрямом целевых свойствах и других концепциях раскадровки анимации см. в разделе " Раскадрованная анимация".

DoubleAnimation обычно имеет по крайней мере один из наборов свойств From, By или To , но никогда не все три.

• Только из: Анимация выполняется из значения, указанного свойством From , к базовому значению анимируемого свойства.
• От и до: Анимация выполняется из значения, указанного свойством From , к значению, указанному свойством To .
• От и по: Анимация выполняется из значения, указанного свойством From , к значению, указанному суммой свойств From и By .
• Только для: Анимация выполняется из базового значения анимированного свойства или выходного значения предыдущей анимации в значение, указанное свойством To .
• Только: Анимация выполняется из базового значения свойства, анимируемого или предыдущего значения анимации, к сумме этого значения и значению, заданному свойством By .

Нельзя анимировать значения X и Yточки с помощью DoubleAnimation, так как эти свойства не являются свойствами зависимостей (точка является структурой и не может иметь свойства зависимостей.) Вместо этого используйте PointAnimation для анимации свойств зависимостей, имеющих значение Point .

Кроме того, нельзя использовать DoubleAnimation для анимации значений и байтов. Вместо этого вам придется использовать ObjectAnimationUsingKeyFrames, что не даст вам поведения интерполяции, поэтому может потребоваться определить несколько ключевых кадров для получения достаточно гладкой анимации. Существует не много свойств зависимостей, связанных с пользовательским интерфейсом, которые используют значения int или байты , поэтому это не должно быть общим сценарием, кроме настраиваемых свойств.

Свойства From, By или To объекта DoubleAnimation не являются строго двойными. Вместо этого это значение NULL для Double. Значение по умолчанию для этих значений равно NULL, а не 0. Это значение NULL — это то, как система анимации различает, что вы не задали конкретное значение. C++ не имеет типа NULL , поэтому вместо этого используется IReference .

См. также раздел

• Timeline
• DoubleAnimationUsingKeyFrames
• Анимированные раскадровки
• Пример анимации XAML
• Double
• Double