IUIAnimationStoryboard2 ::SetStoryboardEventHandler, méthode (uianimation.h)

Spécifie un gestionnaire pour les événements de storyboard.

Syntaxe

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

Paramètres

[in, optional] handler

Gestionnaire que l’animation Windows doit appeler chaque fois que des événements de status et de mise à jour de storyboard se produisent.

L’objet spécifié doit implémenter l’interface IUIAnimationStoryboardEventHandler2 ou avoir la valeur NULL. Pour plus d’informations, consultez Notes.

[in] fRegisterStatusChangeForNextAnimationEvent

Si la valeur est TRUE, inscrit l’événement OnStoryboardStatusChanged et inclut ces événements dans IUIAnimationManager2 ::EstimateNextEventTime, qui estime l’intervalle de temps jusqu’à l’événement d’animation suivant. Pas de valeur par défaut.

[in] fRegisterUpdateForNextAnimationEvent

Si la valeur est TRUE, inscrit l’événement OnStoryboardUpdated et inclut ces événements dans IUIAnimationManager2 ::EstimateNextEventTime, qui estime l’intervalle de temps jusqu’à l’événement d’animation suivant. Pas de valeur par défaut.

Valeur retournée

Retourne S_OK en cas de réussite ; sinon, un code d’erreur HRESULT . Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur d’animation Windows .

Remarques

Le passage de la valeur NULL pour le paramètre de gestionnaire entraîne la libération de la référence de l’animation Windows à n’importe quel objet gestionnaire que vous avez passé précédemment. Cette technique peut être essentielle pour rompre les cycles de référence sans avoir à appeler la méthode IUIAnimationManager2 ::Shutdown .

Configuration requise

Voir aussi

IUIAnimationStoryboard2

IUIAnimationStoryboardEventHandler2