Type BaseObject

 object --+    
          |    
INotifyable --+
              |
             BaseObject

Known Subclasses:

ActionListener, BaseWidget

BaseObject () -> BaseObject

An object class, which is able to receive events.

The BaseObject provides a basic set of methods, which enable it to
be suitable for event driven systems. It is able to listen to
specific event types and runs connected callback functions upon
their occurance.

It is designed for usage with the EventManager class from the
ocempgui.events package and needs to be inherited to be fully
usable.  It can be easily connected to an instance of the
EventManager via the 'manager' attribute (or using the set_manager()
method), which also will remove it from another instance, it was
connected to before. Thus the BaseObject can be only connected to
ONE EventManager instance at a time by default.

The BaseObject class does not provide any predefined signals, it
listens on (those will be called slots here). Instead an inherited
class has to provide its own signal types within the private
'_signals' dictionary. The entries within the '_signals' dictionary
need to be key-value pairs, which have a list as value and a free
choosable type as key (if the default EventCallback class is
used). A typical example about how to create own signal slots
follows:

class OwnObject (BaseObject):
    ...
    def __init__ (self):
        BaseObject.__init__ (self)
        self._signals['ping'] = []
        self._signals['pong'] = []

The OwnObject class can listen to signals, which are strings being
'ping' and 'pong'. It is now possible to connect a callback to those
signals:

obj = OwnObject ()
obj.connect_signal ('ping', cb_func, ...)
obj.connect_signal ('pong', cb_func, ...)

Any instance of the BaseObject class should be explicitly destroyed
using the destroy() method, if it is not needed anymore. This method
takes care of the deletion any callback objects and removes the
object from the connected event manager.

Attributes:
manager  - The event manager for emitting events.