MÉTHODE IDCompositionRotateTransform3D ::SetAxisZ(IDCompositionAnimation*) (dcomp.h)
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