Método IDCompositionAnimation::SetAbsoluteBeginTime (dcompanimation.h)
Define a hora absoluta em que a função de animação é iniciada.
Sintaxe
HRESULT SetAbsoluteBeginTime(
[in] LARGE_INTEGER beginTime
);
Parâmetros
[in] beginTime
Tipo: LARGE_INTEGER
A hora de início dessa 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. Consulte Códigos de Erro do DirectComposition para obter uma lista de códigos de erro.
Comentários
Por padrão, uma função de animação começa quando o primeiro quadro da animação entra em vigor. Por exemplo, se um aplicativo cria uma função de animação simples com um único primitivo no deslocamento zero, associa a animação a alguma propriedade e, em seguida, chama o método IDCompositionDevice::Commit , o primeiro quadro que inclui o commit mostra a animação no deslocamento zero para o primeiro primitivo.
Isso implica que a hora de início padrão real de todas as animações varia dependendo do tempo entre quando o aplicativo cria a animação e chama Commit, até o tempo que leva o mecanismo de composição para pegar as alterações confirmadas. O aplicativo pode usar o método SetAbsoluteBeginTime para exercer um controle mais fino sobre a hora de início de uma animação.
Esse método não controla quando as animações entrarão em vigor; afeta apenas como as animações são amostradas após o início. Se o aplicativo especificar a hora exata do próximo quadro como a hora de início absoluta, o resultado será o mesmo que não chamar esse método. Se a hora de início especificada for diferente da hora do próximo quadro, o resultado será um dos seguintes:
- Se o tempo especificado for posterior ao próximo período, o início da animação será adiado até a hora de início especificada.
- Se a hora especificada for anterior à hora do próximo período, o início da animação será descartado e a amostragem começará na função de animação.
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 |