CompositionObject.StartAnimation Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
StartAnimation(String, CompositionAnimation) |
Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation. |
StartAnimation(String, CompositionAnimation, AnimationController) |
Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation. |
StartAnimation(String, CompositionAnimation)
Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.
public:
virtual void StartAnimation(Platform::String ^ propertyName, CompositionAnimation ^ animation) = StartAnimation;
void StartAnimation(winrt::hstring const& propertyName, CompositionAnimation const& animation);
public void StartAnimation(string propertyName, CompositionAnimation animation);
function startAnimation(propertyName, animation)
Public Sub StartAnimation (propertyName As String, animation As CompositionAnimation)
Paramètres
- propertyName
-
String
Platform::String
winrt::hstring
Propriété à laquelle associer l’animation.
- animation
- CompositionAnimation
Animation à associer à la propriété spécifiée.
Configuration requise pour Windows
Famille d’appareils |
Windows 10 (introduit dans 10.0.10586.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v2.0)
|
Exemples
void AnimatingVisualOffset(Visual targetVisual)
{
var animation = _compositor.CreateVector3KeyFrameAnimation();
//
// Define specific easing functions.
//
var linear = _compositor.CreateLinearEasingFunction();
var easeIn = _compositor.CreateCubicBezierEasingFunction(
new Vector2(0.5f, 0.0f), new Vector2(1.0f, 1.0f));
var easeOut = _compositor.CreateCubicBezierEasingFunction(
new Vector2(0.0f, 0.0f), new Vector2(0.5f, 1.0f));
//
// Add a set of key frames to describe how the Offset should change over time.
//
animation.InsertKeyFrame(0.00f, new Vector3(100.0f, 100.0f, 0.0f));
animation.InsertKeyFrame(0.25f, new Vector3(300.0f, 100.0f, 0.0f), easeIn);
animation.InsertKeyFrame(0.50f, new Vector3(300.0f, 300.0f, 0.0f), linear);
animation.InsertKeyFrame(0.75f, new Vector3(100.0f, 300.0f, 0.0f), linear);
animation.InsertKeyFrame(1.00f, new Vector3(100.0f, 100.0f, 0.0f), easeOut);
//
// The animation curve defined by the key frames will scale to match the duration.
//
animation.Duration = TimeSpan.FromMilliseconds(4000);
targetVisual.StartAnimation("Offset", animation);
}
Remarques
Si une animation est déjà liée à la propriété d’un objet lors de l’appel de StartAnimation, l’animation appliquée précédente est déconnectée et la nouvelle animation est affectée. De même, la définition directe de la propriété entraîne la déconnexion de l’animation précédente et la nouvelle valeur de propriété prend effet.
Le tableau suivant présente la liste des propriétés animatables :
Object | Nom de la propriété | Type de propriété |
---|---|---|
Visuels | AnchorPoint | Vector2 |
CenterPoint | Vector3 | |
Offset | Vector3 | |
Opacity | Scalaire | |
Orientation | Vector4 | |
RotationAngle | Scalaire | |
RotationAxis | Vector3 | |
Taille | Vector2 | |
TransformMatrix | Matrix4x4 | |
InsetClip | BottomInset | Scalaire |
LeftInset | Scalaire | |
RightInset | Scalaire | |
TopInset | Scalaire | |
CompositionColorBrush | Color | Windows.UI.Color |
CompositionPropertySet | Ensemble de propriétés spécifiées par le développeur. |
En outre, les propriétés de certains effets sous l’objet CompositionEffectBrush peuvent être animées :
Nom de l’effet | Nom de la propriété | Type de propriété |
---|---|---|
SaturationEffect | Saturation | Scalaire |
ColorSourceEffect | Color | Vector4 |
ArithmétiqueComposite | Offset | Scalaire |
Source1Amount | Scalaire | |
Source2Amount | Scalaire | |
MultiplyAmount | Scalaire | |
Transform2d | TransformMatrix | Matrix3x2 |
ContrastEffect | Contraste | Float |
ExposureEffect | Exposition : | Float |
HueRotationEffect | Angle | Float |
SepiaEffect | Intensité | Float |
TemperatureAndTintEffect | Température | Float |
Teinte | Float | |
GammaTransferEffect | RedAmplitude | Float |
RedExponent | Float | |
RedOffset | Float | |
GreenAmplitude | Float | |
GreenExponent | Float | |
GreenOffset | Float | |
BlueAmplitude | Float | |
BlueExponent | Float | |
BlueOffset | Float | |
AlphaAmplitude | Float | |
AlphaExponent | Float | |
AlphaOffset | Float |
S’applique à
StartAnimation(String, CompositionAnimation, AnimationController)
Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.
public:
virtual void StartAnimation(Platform::String ^ propertyName, CompositionAnimation ^ animation, AnimationController ^ animationController) = StartAnimation;
/// [Windows.Foundation.Metadata.Overload("StartAnimationWithController")]
void StartAnimation(winrt::hstring const& propertyName, CompositionAnimation const& animation, AnimationController const& animationController);
[Windows.Foundation.Metadata.Overload("StartAnimationWithController")]
public void StartAnimation(string propertyName, CompositionAnimation animation, AnimationController animationController);
function startAnimation(propertyName, animation, animationController)
Public Sub StartAnimation (propertyName As String, animation As CompositionAnimation, animationController As AnimationController)
Paramètres
- propertyName
-
String
Platform::String
winrt::hstring
Propriété à laquelle associer l’animation.
- animation
- CompositionAnimation
Animation à associer à la propriété spécifiée.
- animationController
- AnimationController
Contrôleur d’animation à associer à l’animation.
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 11 Insider Preview (introduit dans 10.0.23504.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v15.0)
|
Remarques
Le animationController
paramètre vous permet de lier plusieurs animations à la propriété Progress d’un contrôleur unique, ce qui nécessite moins d’objets ExpressionAnimation que la liaison des propriétés de Progress
plusieurs animateurs à une propriété CompositionObject.