The event dispatching class.

This is the core of the event system.

There should usually be no need to derive from this class.

Take care to destroy all cEventProducer's before destroying this class! They've got no way to know whether the dispatcher they want to send their events to has been destroyed.

Source:

../src/cEventDispatcher.hh:34

See Also:

cEventProducer

public cEventDispatcher ( ) ;

default constructor

public virtual ~ cEventDispatcher ( ) ;

destructor

protected typedef multimap < const cStorableEvent , cEventConsumer * > tRegisteredEvents ;

protected tRegisteredEvents mRegisteredEvents

public virtual void SubscribeToEvent ( const cEvent & event ,
                                       cEventConsumer * consumer ) ;

register an event consumer for receiving of an event

public virtual void UnsubscribeFromEvent ( const cEvent & event ,
                                           cEventConsumer * consumer ) ;

unregister an event consumer for receiving of an event

public virtual void UnregisterConsumer ( const cEventConsumer * consumer ) ;

unregister a whole consumer

Delete all subscriptions of this consumer (e.g. because it has been destroyed).

public virtual void SendEvent ( const cEvent & event ,
                                bool global = false ) ;

send an event

The event is sent to all subscribers of this event type until one accepts it.

public void DisplayRegistered ( ) ;

for debugging purposes only: display list of registered events

sends the list of registered events to cout