Share via

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

  • Article

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

Syntaxe

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

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