MÉTHODE IDCompositionTranslateTransform3D::SetOffsetZ(IDCompositionAnimation*) (dcomp.h)

Anime la valeur de la propriété OffsetZ d’un effet de transformation de traduction 3D. La propriété OffsetZ spécifie la distance à traduire le long de l’axe z.

Syntaxe

HRESULT SetOffsetZ(
  [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é OffsetZ 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 référencé par le paramètre d’animation est modifié après l’appel de cette méthode, la modification n’affecte pas la propriété OffsetZ, sauf si cette méthode est appelée à nouveau. Si la propriété OffsetZ était précédemment animée, l’appel de cette méthode remplace l’animation précédente 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éé le visuel affecté. 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

IDCompositionTranslateTransform3D

IDCompositionTranslateTransform3D::SetOffsetX

IDCompositionTranslateTransform3D::SetOffsetY