IDCompositionMatrixTransform::SetMatrixElement(int,int,IDCompositionAnimation*) , méthode (dcomp.h)

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

Syntaxe

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

Paramètres

[in] row

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

[in] column

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

[in] animation

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

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 .

Notes

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, sauf si cette méthode est appelée à nouveau. Si l’élément é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.

Spécifications

Voir aussi

IDCompositionMatrixTransform