MÉTHODE IDCompositionMatrixTransform3D ::SetMatrixElement(int,int,IDCompositionAnimation*) (dcomp.h)

Anime la valeur d’un élément de la matrice de cette transformation 3D.

Syntaxe

HRESULT SetMatrixElement(
  [in] int                    row,
  [in] int                    column,
  [in] IDCompositionAnimation *animation
);

Paramètres

[in] row

Type : int

Index de ligne de l’élément à modifier. Cette valeur doit être comprise entre 0 et 3, inclusivement.

[in] column

Type : int

Index de colonne de l’élément à modifier. Cette valeur doit être comprise entre 0 et 3, inclusivement.

[in] animation

Type : IDCompositionAnimation*

Animation qui représente la façon dont la valeur de l’élément spécifié 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

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 l’élément spécifié, sauf si cette méthode est appelée à nouveau. Si l’élément spécifié était précédemment animé, 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 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

Voir aussi

IDCompositionMatrixTransform3D