IDCompositionAnimation::End, méthode (dcompanimation.h)

Ajoute un segment de fin qui marque la fin d’une fonction d’animation.

Syntaxe

HRESULT End(
  [in] double endOffset,
  [in] float  endValue
);

Paramètres

[in] endOffset

Type : double

Décalage, en secondes, entre le début de la fonction d’animation et le point où la fonction se termine.

[in] endValue

Type : float

Valeur finale de l’animation.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Notes

Lorsque le décalage spécifié est atteint, la ou les propriétés affectées par cette animation sont définies sur la valeur finale spécifiée, puis l’animation s’arrête. Si aucun segment de fin n’est ajouté, le segment final de la fonction d’animation s’exécute indéfiniment. L’appel de cette méthode est sémantiquement identique à faire du dernier segment de la fonction d’animation un polynomial cubique où les coefficients cubiques, quadratiques et linéaires sont tous des zéros, et le coefficient constant est la valeur finale souhaitée.

Étant donné que les segments d’animation doivent être ajoutés dans un ordre croissant, cette méthode échoue si le paramètre endOffset est inférieur ou égal au paramètre beginOffset du segment précédent. Cette méthode échoue également s’il s’agit du premier segment à ajouter à la fonction d’animation.

Une fois cette méthode appelée, toutes les méthodes de cet objet d’animation échouent, à l’exception de la méthode IDCompositionAnimation::Reset .

Spécifications

Voir aussi

IDCompositionAnimation