MÉTHODE IDCompositionScaleTransform3D ::SetScaleZ(IDCompositionAnimation*) (dcomp.h)

Anime la valeur de la propriété ScaleZ d’une transformation d’échelle. La propriété ScaleZ spécifie le facteur d’échelle le long de l’axe z.

Syntaxe

HRESULT SetScaleZ(
  [in] IDCompositionAnimation *animation
);

Paramètres

[in] animation

Type : IDCompositionAnimation*

Objet d’animation qui détermine comment la valeur de la propriété ScaleZ change au fil du temps. Ce paramètre ne doit pas être 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 .

Remarques

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é ScaleZ, sauf si cette méthode est appelée à nouveau. Si la propriété ScaleZ é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 n’est pas un pointeur non valide ou si elle n’a pas été créée par la même interface IDCompositionDevice que 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.

Configuration requise

Voir aussi

IDCompositionScaleTransform3D

IDCompositionScaleTransform3D ::SetScaleX

IDCompositionScaleTransform3D ::SetScaley