DoubleAnimation Klasse

Definition

public ref class DoubleAnimation sealed : Timeline

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DoubleAnimation final : Timeline

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

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

Public NotInheritable Class DoubleAnimation
Inherits Timeline

<DoubleAnimation />

Vererbung

Object Platform::Object IInspectable DependencyObject Timeline DoubleAnimation

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Beispiele

Das folgende Beispiel zeigt, wie Sie doubleAnimation verwenden, um ein Rechteck zu erstellen, das nach dem Laden ein- und ausgeblendet wird.

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

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    myStoryboard.Begin()
End Sub

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

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    myStoryboard.Begin()
End Sub

Hinweise

Verwenden Sie DoubleAnimation, um den Eigenschaftswert einer beliebigen Abhängigkeitseigenschaft vom Typ Double zu animieren.

Manchmal müssen Sie indirekte Eigenschaftenziele verwenden, um eine Untereigenschaft eines anderen Objekts als Ziel zu verwenden, die den Wert einer Eigenschaft für das Ziel darstellt. Um beispielsweise die X-Komponente einer RenderTransform eines UIElements zu animieren, müssen Sie auf einige der zwischengeschalteten Objekteigenschaftenwerte verweisen, bis der letzte Schritt im indirekten Eigenschaftenpfad wirklich ein Double-Wert ist, wie es bei TranslateTransform.X der Fall ist. Die richtige Zeichenfolge, die in diesem Beispiel für Storyboard.TargetProperty verwendet werden soll, ist "(UIElement.RenderTransform). (TranslateTransform.X)". Weitere Informationen zu indirekten Eigenschaftenzielen und anderen Konzepten für Storyboardanimationen finden Sie unter Storyboardanimationen.

Eine DoubleAnimation verfügt in der Regel über mindestens eine der Eigenschaften From, By oder To , aber nie alle drei.

• Nur von: Die Animation wird vom Wert, der von der From-Eigenschaft angegeben ist, zum Basiswert der animierten Eigenschaft fortgesetzt.
• Von und bis: Die Animation wird von dem von der From-Eigenschaft angegebenen Wert auf den wert fortgesetzt, der von der To-Eigenschaft angegeben wird.
• Von und nach: Die Animation wird von dem durch die From-Eigenschaft angegebenen Wert zu dem Wert fortgesetzt, der durch die Summe der From - und By-Eigenschaften angegeben wird .
• Nur für: Die Animation wird vom Basiswert der animierten Eigenschaft oder dem Ausgabewert einer vorherigen Animation zu dem wert, der durch die To-Eigenschaft angegeben wird.
• Nur durch: Die Animation geht vom Basiswert der animierten Eigenschaft oder dem Ausgabewert einer vorherigen Animation bis zur Summe dieses Werts und des durch die By-Eigenschaft angegebenen Werts fort.

Sie können die X - und Y-Werte eines Punkts nicht mithilfe einer DoubleAnimation animieren, da diese Eigenschaften keine Abhängigkeitseigenschaften sind (Punkt ist eine Struktur und kann keine Abhängigkeitseigenschaften aufweisen.) Verwenden Sie stattdessen PointAnimation , um Abhängigkeitseigenschaften mit einem Point-Wert zu animieren.

Sie können DoubleAnimation auch nicht verwenden, um Int - oder Bytewerte zu animieren. Stattdessen müssen Sie ObjectAnimationUsingKeyFrames verwenden, was ihnen kein Interpolationsverhalten gibt, sodass Sie möglicherweise mehrere Keyframes definieren müssen, um eine einigermaßen reibungslose Animation zu erhalten. Es gibt nicht viele benutzeroberflächenbezogene Abhängigkeitseigenschaften, die int-Werte oder Bytewerte verwenden, daher sollte dies kein gängiges Szenario sein, außer für benutzerdefinierte Eigenschaften.

Die Eigenschaften From, By oder To einer DoubleAnimation sind nicht unbedingt Double. Stattdessen sind dies nullable für Double. Der Standardwert für diese ist NULL, nicht 0. Dieser NULL-Wert ist, wie das Animationssystem unterscheidet, dass Sie keinen Wert speziell festgelegt haben. Visual C++-Komponentenerweiterungen (C++/CX) verfügen nicht über einen Nullable-Typ und nutzen stattdessen IReference.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• Timeline
• DoubleAnimationUsingKeyFrames
• Storyboardanimationen
• XAML-Animationsbeispiel
• Double
• Double