IDCompositionVisual::SetOffsetY(IDCompositionAnimation*) , méthode (dcomp.h)

Anime la valeur de la propriété OffsetY de ce visuel. La propriété OffsetY spécifie le nouveau décalage du visuel le long de l’axe y, par rapport au visuel parent.

Syntaxe

HRESULT SetOffsetY(
  [in] IDCompositionAnimation *animation
);

Paramètres

[in] animation

Type : IDCompositionAnimation*

Objet d’animation qui détermine la façon dont la valeur de la propriété OffsetY change au fil du temps. Ce paramètre ne doit pas avoir la valeur NULL.

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

Cette méthode effectue une copie de l’animation spécifiée. Si l’objet d’animation référencé par le paramètre d’animation est modifié après cet appel, la modification n’affecte pas la propriété OffsetY, sauf si cette méthode est appelée à nouveau. Si la propriété OffsetY était précédemment animée, cette méthode remplace cette animation par la nouvelle animation.

Cette méthode échoue si l’animation est un pointeur non valide ou si elle n’a pas été créée par la même interface IDCompositionDevice qui a créé ce visuel. L’interface ne peut pas être une implémentation personnalisée ; seules les interfaces créées par Microsoft DirectComposition peuvent être utilisées avec cette méthode.

Spécifications

Voir aussi

IDCompositionVisual

IDCompositionVisual::SetOffsetX

IDCompositionVisual::SetTransform