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

  • Article

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

Syntaxe

HRESULT SetAxisX(
  [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é AxisX 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 .

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

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 ::SetAxisY

IDCompositionRotateTransform3D ::SetAxisZ