Compartilhar via


Método IDCompositionAnimation::End (dcompanimation.h)

Adiciona um segmento final que marca o fim de uma função de animação.

Sintaxe

HRESULT End(
  [in] double endOffset,
  [in] float  endValue
);

Parâmetros

[in] endOffset

Tipo: double

O deslocamento, em segundos, desde o início da função de animação até o ponto em que a função termina.

[in] endValue

Tipo: float

O valor final da animação.

Valor retornado

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

Quando o deslocamento especificado é atingido, a propriedade ou as propriedades afetadas por essa animação são definidas como o valor final especificado e, em seguida, a animação é interrompida. Se nenhum segmento final for adicionado, o segmento final da função de animação será executado indefinidamente. Chamar esse método é semanticamente idêntico a tornar o último segmento da função de animação um polinomial cúbico em que os coeficientes cúbicos, quadráticos e lineares são todos zeros, e o coeficiente constante é o valor final desejado.

Como os segmentos de animação devem ser adicionados em ordem crescente, esse método falhará se o parâmetro endOffset for menor ou igual ao parâmetro beginOffset do segmento anterior. Esse método também falhará se este for o primeiro segmento a ser adicionado à função de animação.

Depois que esse método é chamado, todos os métodos neste objeto de animação falham, exceto o método IDCompositionAnimation::Reset .

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 dcompanimation.h
Biblioteca Dcomp.lib
DLL Dcomp.dll

Confira também

IDCompositionAnimation