Main Page   Class Hierarchy   Compound List   File List   Compound Members   File Members  

PNotifier Class Reference

#include <notifier.h>

Inheritance diagram for PNotifier:

PSmartPointer PObject List of all members.

Public Methods

 PNotifier (PNotifierFunction *func=NULL)
virtual void operator() (PObject &notifier, INT extra) const

Detailed Description

This class is the PSmartPointer# to the PNotifierFunction# class.

The PNotifier and PNotifierFunction# classes build a completely type safe mechanism for calling arbitrary member functions on classes. The "pointer to a member function" capability built into C++ makes the assumption that the function name exists in an ancestor class. If you wish to call a member function name that does {\bf not} exist in any ancestor class, very type unsafe casting of the member functions must be made. Some compilers will even refuse to do it at all!

To overcome this problem, as this mechanism is highly desirable for callback functions in the GUI part of the PWLib library, these classes and a macro are used to create all the classes and declarations to use polymorphism as the link between the caller, which has no knowledege of the function, and the receiver object and member function.

This is most often used as the notification of actions being take by interactors in the PWLib library.


Constructor & Destructor Documentation

PNotifier::PNotifier PNotifierFunction   func = NULL [inline]
 

Create a new notification function smart pointer.

Parameters:
func  Notifier function to call.


Member Function Documentation

virtual void PNotifier::operator() PObject   notifier,
INT    extra
const [inline, virtual]
 

Execute the call to the actual notification function on the object instance contained in this object. This will make a polymorphic call to the function declared by the PDECLARE_NOTIFIER# macro which in turn calls the required function in the destination object.

Parameters:
extra  Object that is making the notification. Extra information that may be passed to function.


The documentation for this class was generated from the following file:
Generated on Fri Aug 13 15:50:08 2004 for PWLib by doxygen1.2.18