Metodo IDCompositionMatrixTransform3D::SetMatrixElement(int,int,IDCompositionAnimation*) (dcomp.h)

Anima il valore di un elemento della matrice di questa trasformazione 3D.

Sintassi

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

Parametri

[in] row

Tipo: int

Indice di riga dell'elemento da modificare. Questo valore deve essere compreso tra 0 e 3 inclusi.

[in] column

Tipo: int

Indice di colonna dell'elemento da modificare. Questo valore deve essere compreso tra 0 e 3 inclusi.

[in] animation

Tipo: IDCompositionAnimation*

Animazione che rappresenta il modo in cui il valore dell'elemento specificato cambia nel tempo. Questo parametro non deve essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore directComposition .

Commenti

Questo metodo crea una copia dell'animazione specificata. Se l'oggetto a cui fa riferimento il parametro di animazione viene modificato dopo aver chiamato questo metodo, la modifica non influisce sull'elemento specificato, a meno che questo metodo non venga chiamato di nuovo. Se l'elemento specificato è stato animato in precedenza, la chiamata a questo metodo sostituisce l'animazione precedente con la nuova animazione.

Questo metodo ha esito negativo se l'animazione è un puntatore non valido o se non è stata creata dalla stessa interfaccia IDCompositionDevice della trasformazione interessata. L'interfaccia non può essere un'implementazione personalizzata; con questo metodo è possibile usare solo le interfacce create da Microsoft DirectComposition.

Requisiti

Vedi anche

IDCompositionMatrixTransform3D