PointAnimation Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Media.Animation

Anima il valore di una proprietà Point tra due valori di destinazione usando l'interpolazione lineare su una durata specificata.

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

Ereditarietà

Object Platform::Object IInspectable DependencyObject Timeline PointAnimation

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio seguente illustra come usare PointAnimation per animare la proprietà Center di un oggetto EllipseGeometry.

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

Commenti

Usare PointAnimation per animare il valore della proprietà di qualsiasi proprietà di dipendenza di tipo Point.

L'interpolazione lineare per un punto indica che i valori X e Y vengono considerati come un numero e l'interpolazione è semplicemente un'operazione matematica.

In alcuni casi è necessario usare la destinazione della proprietà indiretta per definire come destinazione una sottoproprietà di un altro oggetto che rappresenta il valore di una proprietà nella destinazione. Ad esempio, per animare parti di un oggetto PathGeometry, è necessario fare riferimento ad alcuni dei valori intermedi della proprietà oggetto, fino all'ultimo passaggio nel percorso della proprietà indiretta è effettivamente un valore Point . Per altre info sulla destinazione delle proprietà indirette e su altri concetti relativi all'animazione con storyboard, vedi Animazioni con storyboard o sintassi property-path.

Una proprietà PointAnimation ha in genere almeno una delle proprietà From, By o To impostate, ma non tutte e tre.

• Solo da: L'animazione passa dal valore specificato dalla proprietà From al valore di base della proprietà animata.
• Da e a: L'animazione passa dal valore specificato dalla proprietà From al valore specificato dalla proprietà To .
• Da e per: L'animazione passa dal valore specificato dalla proprietà From al valore specificato dalla somma delle proprietà From e By .
• Solo per: L'animazione procede dal valore di base della proprietà animata o dal valore di output di un'animazione precedente al valore specificato dalla proprietà To .
• Solo per: L'animazione passa dal valore di base della proprietà animata o dal valore di output di un'animazione precedente alla somma di tale valore e al valore specificato dalla proprietà By .

Le proprietà From, By o To di pointAnimation non sono un valore Point . Si tratta invece di un valore Nullable per Point. Il valore predefinito per questi valori è Null, non una struttura non inizializzata. Questo valore Null è il modo in cui il sistema di animazione distingue che non è stato impostato in modo specifico un valore. Non esiste il tipo Nullable delle estensioni del componente Visual C++ (C++/CX) e al suo posto si usa il tipo IReference.

Costruttori

PointAnimation()

Inizializza una nuova istanza della classe PointAnimation .

Proprietà

AutoReverse	Ottiene o imposta un valore che indica se la sequenza temporale viene riprodotta in senso inverso dopo il completamento di un'iterazione in avanti. (Ereditato da Timeline)
BeginTime	Ottiene o imposta l'ora di inizio della sequenza temporale . (Ereditato da Timeline)
By	Ottiene o imposta la quantità totale in base alla quale l'animazione modifica il valore iniziale.
ByProperty	Identifica la proprietà di dipendenza By .
Dispatcher	Ottiene coreDispatcher a cui è associato questo oggetto. CoreDispatcher rappresenta una funzionalità che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non dell'interfaccia utente. (Ereditato da DependencyObject)
Duration	Ottiene o imposta la durata di riproduzione di questa sequenza temporale, senza contare le ripetizioni. (Ereditato da Timeline)
EasingFunction	Ottiene o imposta la funzione di interpolazione da applicare all'animazione.
EasingFunctionProperty	Identifica la proprietà di dipendenza EasingFunction .
EnableDependentAnimation	Ottiene o imposta un valore che dichiara se le proprietà animate considerate animazioni dipendenti devono essere autorizzate a usare questa dichiarazione di animazione.
EnableDependentAnimationProperty	Identifica la proprietà di dipendenza EnableDependentAnimation .
FillBehavior	Ottiene o imposta un valore che specifica il comportamento dell'animazione dopo che raggiunge la fine del periodo attivo. (Ereditato da Timeline)
From	Ottiene o imposta il valore iniziale dell'animazione.
FromProperty	Identifica la proprietà Di dipendenza.
RepeatBehavior	Ottiene o imposta il comportamento di ripetizione della sequenza temporale. (Ereditato da Timeline)
SpeedRatio	Ottiene o imposta la frequenza, rispetto al relativo elemento padre, in cui l'ora avanza per questa sequenza temporale. (Ereditato da Timeline)
To	Ottiene o imposta il valore finale dell'animazione.
ToProperty	Identifica la proprietà To dependency.

Metodi

ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale. (Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una funzione di notifica per l'ascolto delle modifiche apportate a una dipendenza specifica in questa istanza di DependencyObject . (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza su dependencyObject. (Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject)

Eventi

Completed

Si verifica al completamento della riproduzione dell'oggetto Storyboard . (Ereditato da Timeline)

Vedi anche

• Timeline
• Point
• PointAnimationUsingKeyFrames
• Animazioni con storyboard
• Esempio di animazione XAML