Método IDCompositionMatrixTransform::SetMatrixElement(int,int,IDCompositionAnimation*) (dcomp.h)
Anima o valor de um elemento da matriz dessa transformação 2D.
Sintaxe
HRESULT SetMatrixElement(
[in] int row,
[in] int column,
[in] IDCompositionAnimation *animation
);
Parâmetros
[in] row
O índice de linha do elemento a ser alterado. Esse valor deve estar entre 0 e 2, inclusive.
[in] column
O índice de coluna do elemento a ser alterado. Esse valor deve estar entre 0 e 1, inclusive.
[in] animation
Uma animação que representa como o valor do elemento especificado é alterado ao longo do tempo. Esse parâmetro não deve ser NULL.
Valor retornado
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, a menos que esse método seja chamado novamente. Se o elemento 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
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | dcomp.h |
| Biblioteca | Dcomp.lib |
| DLL | Dcomp.dll |