PointAnimation Classe

Définition

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

Public NotInheritable Class PointAnimation
Inherits Timeline

<PointAnimation .../>

Héritage

Object Platform::Object IInspectable DependencyObject Timeline PointAnimation

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

L’exemple suivant montre comment utiliser PointAnimation pour animer la propriété Center d’un 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();
}

Remarques

Utilisez PointAnimation pour animer la valeur de propriété de toute propriété de dépendance de type Point.

L’interpolation linéaire pour un point signifie que les valeurs X et Y sont traitées comme un nombre et que l’interpolation est simplement une opération mathématique.

Parfois, vous devez utiliser le ciblage de propriété indirect pour cibler une sous-propriété d’un autre objet qui est la valeur d’une propriété sur la cible. Par exemple, pour animer des parties d’un PathGeometry, vous devez référencer certaines des valeurs de propriété d’objet intermédiaire jusqu’à ce que la dernière étape du chemin de propriété indirect soit réellement une valeur point . Pour plus d’informations sur le ciblage de propriétés indirectes et d’autres concepts d’animation storyboarded, consultez la syntaxe des animations storyboarded ou property-path.

Un PointAnimation a généralement au moins l’une des propriétés From, By ou To définies, mais jamais les trois.

• À partir de seulement : L’animation passe de la valeur spécifiée par la propriété From à la valeur de base de la propriété animée.
• De et vers : L’animation passe de la valeur spécifiée par la propriété From à la valeur spécifiée par la propriété To .
• De et par : L’animation passe de la valeur spécifiée par la propriété From à la valeur spécifiée par la somme des propriétés From et By .
• Pour uniquement : L’animation passe de la valeur de base de la propriété animée ou de la valeur de sortie d’une animation précédente à la valeur spécifiée par la propriété To .
• Par seulement : L’animation passe de la valeur de base de la propriété animée ou de la valeur de sortie d’une animation précédente à la somme de cette valeur et de la valeur spécifiée par la propriété By .

Les propriétés From, By ou To d’un PointAnimation ne sont pas une valeur Point . Au lieu de cela, il s’agit d’une valeur Nullable pour point. La valeur par défaut de ces valeurs est Null, et non une structure non initialisée. Cette valeur Null est la façon dont le système d’animation distingue que vous n’avez pas spécifiquement défini de valeur. C++ n’a pas de type Nullable . Il utilise plutôt IReference .

Voir aussi

• Timeline
• PointAnimationUsingKeyFrames
• Animations scénarisées
• Exemple d’animation XAML
• Point