Event Handlers

From SmartWin Wiki

An Event Handler is either a member function in a Widget classes or a global/static function which you supply to SmartWin++ to register interest in some Event. (See Events.)

An Event Handler has a method signature and some expected behavior. For instance, an event called onClosing might be called just before a Widget is to be closed and expect the client code to return true if the Widget should be closed and false if not. This would make the signature of the Event Handler "bool foo();" If you supply global or static functions to SmartWin++ as an Event Handler, the event handler must always take an extra parameter as its first argument--a pointer to the type of the Widget. Example: "bool foo( MyWidget * );"

You supply interest in an Event by registering interest it through an Event Handler setter function. The name of this function differs from Event to Event but all are prefixed on. For example, the Event Handler setter function for the Activate Event is named "onActivate".