Conseils d'utilisation

Pour être averti des mises à jour du PS utilisant cette classe, l'application doit effectuer les étapes suivantes :

1. Définir une classe dérivée d'ECLPSNotify.
2. Implémenter la méthode NotifyEvent de la classe dérivée d'ECLPSNotify.
3. Implémenter éventuellement d’autres fonctions membres d’ECLPSNotify.
4. Créer une instance de la classe dérivée.
5. Enregistrer l'instance avec la méthode ECLPS::RegisterPSEvent().

Une fois l'enregistrement terminé, les mises à jour de l'espace de présentation entraîneront l'appel de la méthode NotifyEvent() de la classe dérivée d'ECLPSNotify.

Notez que plusieurs mises à jour du PS qui se produisent sur une courte période peuvent être regroupées en une seule notification d'événement.

Une application peut choisir de fournir ses propres constructeur et destructeur pour la classe dérivée. Cela peut être utile si l'application doit stocker des données spécifiques à l'instance dans la classe et transmettre ces informations en tant que paramètre au constructeur.

Si une erreur est détectée lors de l'enregistrement d'un événement, la fonction membre NotifyError() est appelée avec un objet ECLErr. Les événements peuvent ou non continuer à être générés après une erreur. Lorsque la génération d'événements se termine (en raison d'une erreur ou pour une autre raison), la fonction membre NotifyStop() est appelée. L'implémentation par défaut de NotifyError() présentera une boîte de message à l'utilisateur affichant le texte des messages d'erreur récupérés de l'objet ECLErr.

Lorsque la notification d'événement s'arrête pour une raison quelconque (erreur ou appel à ECLPS::UnregisterPSEvent), la fonction membre NotifyStop() est appelée. L'implémentation par défaut de NotifyStop() ne fait rien.