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

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

Sintassi

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

Parametri

[in] row

Indice di riga dell'elemento da modificare. Questo valore deve essere compreso tra 0 e 2, inclusivo.

[in] column

Indice della colonna dell'elemento da modificare. Questo valore deve essere compreso tra 0 e 1, inclusivo.

[in] animation

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

Valore restituito

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 esegue 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 a meno che questo metodo non venga chiamato di nuovo. Se l'elemento è 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; è possibile usare solo interfacce create da Microsoft DirectComposition con questo metodo.

Requisiti

Vedi anche

IDCompositionMatrixTransform