Método IUIAnimationStoryboard2::SetStoryboardEventHandler (uianimation.h)
Especifica um manipulador para eventos de storyboard.
Sintaxe
HRESULT SetStoryboardEventHandler(
[in, optional] IUIAnimationStoryboardEventHandler2 *handler,
[in] BOOL fRegisterStatusChangeForNextAnimationEvent,
[in] BOOL fRegisterUpdateForNextAnimationEvent
);
Parâmetros
[in, optional] handler
O manipulador que a Animação do Windows deve chamar sempre que o storyboard status e eventos de atualização ocorrem.
O objeto especificado deve implementar a interface IUIAnimationStoryboardEventHandler2 ou ser NULL. Consulte Comentários para obter mais informações.
[in] fRegisterStatusChangeForNextAnimationEvent
Se TRUE, registrará o evento OnStoryboardStatusChanged e incluirá esses eventos em IUIAnimationManager2::EstimateNextEventTime, que estima o intervalo de tempo até o próximo evento de animação. Sem valor padrão.
[in] fRegisterUpdateForNextAnimationEvent
Se TRUE, registrará o evento OnStoryboardUpdated e incluirá esses eventos em IUIAnimationManager2::EstimateNextEventTime, que estima o intervalo de tempo até o próximo evento de animação. Sem valor padrão.
Retornar valor
Retorna S_OK se tiver êxito; caso contrário, um código de erro HRESULT . Consulte Códigos de erro de animação do Windows para obter uma lista de códigos de erro.
Comentários
Passar NULL para o parâmetro de manipulador faz com que a Animação do Windows libere sua referência a qualquer objeto de manipulador que você passou anteriormente. Essa técnica pode ser essencial para quebrar ciclos de referência sem precisar chamar o método IUIAnimationManager2::Shutdown .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8, Windows 7 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | uianimation.h |
| DLL | UIAnimation.dll |