Compartilhar via


Método IDCompositionRotateTransform3D::SetAxisZ(IDCompositionAnimation*) (dcomp.h)

Anima o valor da propriedade AxisZ de uma transformação de rotação 3D. A propriedade AxisZ especifica a coordenada z para o vetor do eixo de rotação. O valor padrão é 1.0.

Sintaxe

HRESULT SetAxisZ(
  [in] IDCompositionAnimation *animation
);

Parâmetros

[in] animation

Tipo: IDCompositionAnimation*

Um objeto de animação que determina como o valor da propriedade AxisZ muda 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. Consulte Códigos de Erro do DirectComposition para obter uma lista de códigos de erro.

Comentários

Ao definir o eixo como um valor não padrão, você sempre deve definir todas as três propriedades de eixo (AxisX, AxisY e AxisZ).

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á a propriedade AxisZ, a menos que esse método seja chamado novamente. Se a propriedade AxisZ foi animada 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 3D afetada. A interface não pode ser uma implementação personalizada; somente as interfaces criadas pelo Microsoft DirectComposition podem ser usadas com esse método.

O valor padrão é 0.

Requisitos

Requisito Valor
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

Confira também

IDCompositionRotateTransform3D

IDCompositionRotateTransform3D::SetAxisX

IDCompositionRotateTransform3D::SetAxisY