class PNotifierFunction: public PSmartObject

This class is the PSmartObject contents of the PNotifier class.

Inheritance:


Public Methods

[more] PNotifierFunction ( void * obj Object instance that the function will be called on. )
Create a notification function instance.
[more]virtual void Call ( PObject & notifier, INT extra ) const
Execute the call to the actual notification function on the object instance contained in this object.

Protected Fields

[more]void* object
Object instance to receive the notification function call.


Inherited from PSmartObject:

Protected Fields

ounsigned referenceCount


Inherited from PObject:

Public

Run Time Type functions

Comparison functions

I/O functions

Miscellaneous functions


Documentation

This class is the PSmartObject contents of the PNotifier class.

This is an abstract class for which a descendent is declared for every function that may be called. The PDECLARE_NOTIFIER macro makes this declaration.

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 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.

o PNotifierFunction( void * obj Object instance that the function will be called on. )
Create a notification function instance.

ovirtual void Call( PObject & notifier, INT extra ) const
Execute the call to the actual notification function on the object instance contained in this object.
Parameters:
notifier - Object that is making the notification.
extra - Extra information that may be passed to function.

ovoid* object
Object instance to receive the notification function call.


Direct child classes:
PCommandSource

Alphabetic index HTML hierarchy of classes or Java



This page was generated with the help of DOC++.