PointAnimation Klasse

Definition

Namespace:

Windows.UI.Xaml.Media.Animation

Animiert den Wert einer Point-Eigenschaft zwischen zwei Zielwerten mithilfe einer linearen Interpolation über eine angegebene Dauer.

public ref class PointAnimation sealed : 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 PointAnimation final : 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 PointAnimation : Timeline

Public NotInheritable Class PointAnimation
Inherits Timeline

<PointAnimation .../>

Vererbung

Object Platform::Object IInspectable DependencyObject Timeline PointAnimation

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das folgende Beispiel zeigt, wie Sie pointAnimation verwenden, um die Center-Eigenschaft einer EllipseGeometry-Eigenschaft zu animieren.

// Start the animation when the object loads
void SampleApp::Page::Start_Animation(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
    myStoryboard->Begin();
}

<Canvas Width="450" Height="350">
    <Canvas.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Animate the center point of the ellipse from 100 X, 300 Y
             to 400 X, 100 Y over 5 seconds. -->
            <PointAnimation
             Storyboard.TargetProperty="Center"
             Storyboard.TargetName="MyAnimatedEllipseGeometry"
             Duration="0:0:5" 
             From="100,300"
             To="400,100"
             RepeatBehavior="Forever" EnableDependentAnimation="True"/>

        </Storyboard>
    </Canvas.Resources>
    <Path Fill="Blue" Loaded="Start_Animation">
        <Path.Data>

            <!-- Describes an ellipse. -->
            <EllipseGeometry x:Name="MyAnimatedEllipseGeometry"
             Center="200,100" RadiusX="15" RadiusY="15" />
        </Path.Data>
    </Path>
</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 PointAnimation, um den Eigenschaftswert einer beliebigen Abhängigkeitseigenschaft vom Typ Point zu animieren.

Lineare Interpolation für einen Punkt bedeutet, dass X - und Y-Werte als Zahl behandelt werden und die Interpolation einfach eine mathematische Operation ist.

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 z. B. Teile einer PathGeometry animieren zu können, müssen Sie auf einige der zwischenliegenden Objekteigenschaftenwerte verweisen, bis der letzte Schritt im indirekten Eigenschaftenpfad wirklich ein Punktwert ist. Weitere Informationen zu indirekten Eigenschaftenzielen und anderen Konzepten für Storyboardanimationen finden Sie unter Storyboardanimationen oder Eigenschaftenpfadsyntax.

Für eine PointAnimation ist in der Regel mindestens eine der Eigenschaften From, By oder To festgelegt, 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.

Die Eigenschaften From, By oder To einer PointAnimation sind kein Point-Wert . Stattdessen sind dies nullable für Point. Der Standardwert für diese ist NULL, keine nicht initialisierte Struktur. 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

PointAnimation()

Initialisiert eine neue instance der PointAnimation-Klasse.

Eigenschaften

AutoReverse	Ruft einen Wert ab, der angibt, ob die Zeitachse nach einem vollständigen Durchgang vorwärts in umgekehrter Reihenfolge abspielt. (Geerbt von Timeline)
BeginTime	Ruft den Zeitpunkt ab, zu dem diese Zeitachse beginnen soll, oder legt diese fest. (Geerbt von Timeline)
By	Ruft den Gesamtbetrag ab, um den die Animation ihren Startwert ändert, oder legt diesen fest.
ByProperty	Identifiziert die By-Abhängigkeitseigenschaft.
Dispatcher	Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
Duration	Ruft die Zeitdauer ab, für die diese Zeitachse wiedergegeben wird, ohne Wiederholungen, oder legt diese fest. (Geerbt von Timeline)
EasingFunction	Ruft die Beschleunigungsfunktion ab, die Sie auf die Animation anwenden, oder legt sie fest.
EasingFunctionProperty	Gibt die EasingFunction-Abhängigkeitseigenschaft an.
EnableDependentAnimation	Ruft einen Wert ab, der deklariert, ob animierte Eigenschaften, die als abhängige Animationen gelten, diese Animationsdeklaration verwenden dürfen, oder legt diesen wert fest.
EnableDependentAnimationProperty	Gibt die Abhängigkeitseigenschaft EnableDependentAnimation an.
FillBehavior	Ruft einen Wert ab, der angibt, wie sich die Animation verhält, nachdem sie das Ende ihres aktiven Zeitraums erreicht hat, oder legt diesen fest. (Geerbt von Timeline)
From	Ruft den Anfangswert der Animation ab oder legt ihn fest.
FromProperty	Gibt die From-Abhängigkeitseigenschaft an.
RepeatBehavior	Ruft das Wiederholungsverhalten dieser Zeitachse ab oder legt es fest. (Geerbt von Timeline)
SpeedRatio	Ruft die Rate im Verhältnis zu ihrem übergeordneten Element ab, zu dem die Zeit für diese Zeitachse voranschreitet, oder legt diese fest. (Geerbt von Timeline)
To	Ruft den Endwert der Animation ab oder legt ihn fest.
ToProperty	Gibt die To-Abhängigkeitseigenschaft an.

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde. (Geerbt von DependencyObject)

Ereignisse

Completed

Tritt auf, wenn die Wiedergabe des Storyboard-Objekts abgeschlossen ist. (Geerbt von Timeline)

Weitere Informationen

• Timeline
• Point
• PointAnimationUsingKeyFrames
• Storyboardanimationen
• XAML-Animationsbeispiel