Share via

MÉTHODE IDCompositionRotateTransform3D ::SetAxisZ(IDCompositionAnimation*) (dcomp.h)

  • Article

Anime la valeur de la propriété AxisZ d’une transformation de rotation 3D. La propriété AxisZ spécifie la coordonnée z pour le vecteur de rotation de l’axe. La valeur par défaut est 1,0.

Syntaxe

HRESULT SetAxisZ(
  [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é AxisZ 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

Lorsque vous définissez l’axe sur une valeur autre que celle par défaut, vous devez toujours définir les trois propriétés d’axe (AxisX, AxisY et AxisZ).

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é AxisZ, sauf si cette méthode est appelée à nouveau. Si la propriété AxisZ é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 la transformation 3D affectée. 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.

La valeur par défaut est 0.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête dcomp.h
Bibliothèque Dcomp.lib
DLL Dcomp.dll

Voir aussi

IDCompositionRotateTransform3D

IDCompositionRotateTransform3D ::SetAxisX

IDCompositionRotateTransform3D ::SetAxisY