Compartir a través de


Método IUIAnimationStoryboard2::SetStoryboardEventHandler (uianimation.h)

Especifica un controlador para eventos de guión gráfico.

Sintaxis

HRESULT SetStoryboardEventHandler(
  [in, optional] IUIAnimationStoryboardEventHandler2 *handler,
  [in]           BOOL                                fRegisterStatusChangeForNextAnimationEvent,
  [in]           BOOL                                fRegisterUpdateForNextAnimationEvent
);

Parámetros

[in, optional] handler

Controlador al que debe llamar la animación de Windows cada vez que se produzcan eventos de actualización y estado del guión gráfico.

El objeto especificado debe implementar la interfaz IUIAnimationStoryboardEventHandler2 o ser NULL. Consulta Comentarios para obtener más información.

[in] fRegisterStatusChangeForNextAnimationEvent

Si es TRUE, registra el evento OnStoryboardStatusChanged e incluye esos eventos en IUIAnimationManager2::EstimateNextEventTime, que calcula el intervalo de tiempo hasta el siguiente evento de animación. Ningún valor predeterminado.

[in] fRegisterUpdateForNextAnimationEvent

Si es TRUE, registra el evento OnStoryboardUpdated e incluye esos eventos en IUIAnimationManager2::EstimateNextEventTime, que calcula el intervalo de tiempo hasta el siguiente evento de animación. Ningún valor predeterminado.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente; de lo contrario, un código de error HRESULT . Consulta Códigos de error de animación de Windows para obtener una lista de códigos de error.

Comentarios

Pasar NULL para el parámetro de controlador hace que La animación de Windows libere su referencia a cualquier objeto de controlador que haya pasado anteriormente. Esta técnica puede ser esencial para interrumpir los ciclos de referencia sin tener que llamar al método IUIAnimationManager2::Shutdown .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8, Windows 7 y Actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado uianimation.h
Archivo DLL UIAnimation.dll

Consulte también

IUIAnimationStoryboard2

IUIAnimationStoryboardEventHandler2