DoubleAnimation Classe

Definição

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

Herança

Object Platform::Object IInspectable DependencyObject Timeline DoubleAnimation

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

O exemplo a seguir mostra como usar DoubleAnimation para criar um retângulo que desaparece dentro e fora de exibição depois que ele é carregado.

<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();
}

Comentários

Use DoubleAnimation para animar o valor da propriedade de qualquer propriedade de dependência do tipo Double.

Às vezes, você precisará usar o direcionamento indireto de propriedade para direcionar uma sub-propriedade de outro objeto que seja o valor de uma propriedade no destino. Por exemplo, para animar o componente X de um RenderTransform de um UIElement, você precisa referenciar alguns dos valores intermediários de propriedade de objeto, até que a última etapa no caminho da propriedade indireta seja realmente um valor Duplo , como é o caso de TranslateTransform.X. A cadeia de caracteres correta a ser usada para Storyboard.TargetProperty neste exemplo é "(UIElement.RenderTransform). (TranslateTransform.X)". Para obter mais informações sobre direcionamento de propriedade indireta e outros conceitos de animação storyboarded, consulte animações storyboarded.

Uma DoubleAnimation normalmente tem pelo menos uma das propriedades From, By ou To definidas, mas nunca todas as três.

• Somente de: A animação progride do valor especificado pela propriedade From para o valor base da propriedade que está sendo animada.
• De e para: A animação progride do valor especificado pela propriedade From para o valor especificado pela propriedade To .
• De e por: A animação progride do valor especificado pela propriedade From para o valor especificado pela soma das propriedades De e Por .
• Somente para: A animação progride do valor base da propriedade animada ou do valor de saída de uma animação anterior para o valor especificado pela propriedade To .
• Por apenas: A animação progride do valor base da propriedade que está sendo animada ou do valor de saída de uma animação anterior para a soma desse valor e o valor especificado pela propriedade By .

Você não pode animar os valores X e Y de um Ponto usando um DoubleAnimation, pois essas propriedades não são propriedades de dependência (Point é uma estrutura e não pode ter propriedades de dependência.) Em vez disso, use PointAnimation para animar propriedades de dependência que têm um valor point .

Você também não pode usar DoubleAnimation para animar valores de bytes ou valores de int. Em vez disso, você precisará usar ObjectAnimationUsingKeyFrames, o que não lhe dará um comportamento de interpolação, portanto, talvez seja necessário definir vários quadros-chave para obter uma animação razoavelmente suave. Não há muitas propriedades de dependência relacionadas à interface do usuário que usam valores de bytes ou valores de bytesint, portanto, esse não deve ser um cenário comum que não seja para propriedades personalizadas.

As propriedades From, By ou To de um DoubleAnimation não são estritamente um Double. Em vez disso, estas são uma anulável para Double. O valor padrão para eles é nulo, não 0. Esse valor nulo é como o sistema de animação distingue que você não definiu especificamente um valor. O C++ não tem um tipo anulável , portanto, ele usa IReference .

Confira também

• Timeline
• DoubleAnimationUsingKeyFrames
• animações animadas a partir de storyboards
• Exemplo de animação XAML
• Double
• Double