Método IDCompositionMatrixTransform3D::SetMatrixElement(int,int,IDCompositionAnimation*) (dcomp.h)

Anima o valor de um elemento da matriz dessa transformação 3D.

Sintaxe

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

Parâmetros

[in] row

Tipo: int

O índice de linha do elemento a ser alterado. Esse valor deve estar entre 0 e 3, inclusive.

[in] column

Tipo: int

O índice de coluna do elemento a ser alterado. Esse valor deve estar entre 0 e 3, inclusive.

[in] animation

Tipo: IDCompositionAnimation*

Uma animação que representa como o valor do elemento especificado é alterado ao longo do tempo. Esse parâmetro não deve ser NULL.

Retornar valor

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Confira Códigos de erro do DirectComposition para obter uma lista de códigos de erro.

Comentários

Esse método faz uma cópia da animação especificada. Se o objeto referenciado pelo parâmetro de animação for alterado após chamar esse método, a alteração não afetará o elemento especificado, a menos que esse método seja chamado novamente. Se o elemento especificado tiver sido animado anteriormente, chamar esse método substituirá a animação anterior pela nova animação.

Esse método falhará se a animação for um ponteiro inválido ou se não tiver sido criada pela mesma interface IDCompositionDevice que a transformação afetada. A interface não pode ser uma implementação personalizada; somente interfaces criadas pelo Microsoft DirectComposition podem ser usadas com esse método.

Requisitos

Confira também

IDCompositionMatrixTransform3D