IEditHandler

The IEditHandler class handles events resulting from a user changing a control's input value, such as changing the value of an entry field or moving the arm of a slider. IEditHandler objects process edit events for the following controls:

You create a handler derived from IEditHandler and attach it to either the control whose input users can change or to the control's owner window. You can do this by calling IHandler::handleEventsFor to pass the appropriate control window or owner window to the edit handler.

When the edit handler receives an edit event, it creates an IControlEvent object and routes that object to the IEditHandler::edit virtual function. You override this virtual function to supply your own specialized processing of an edit event.

The following return values from the virtual function specify whether the control event is passed on for additional processing:

true
The edit event requires no additional processing. Do not pass it to another handler.
false
The edit event requires additional processing. Pass the edit event to the next handler, as follows:
  • If there is another handler for the control, pass the edit event to the next handler.
  • If this is the last handler for the control, call IWindow::dispatch to dispatch the edit event to the control's owner window.
  • If this is the last handler for the owner window, call IWindow::defaultProcedure to process the edit event.


IEditHandler - Member Functions and Data by Group

Constructors & Destructor

Only derived classes can construct objects of this class.


[view class]
~IEditHandler
public:
virtual ~IEditHandler()

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
IEditHandler
protected:
IEditHandler()

Derived classes call this default constructor to create objects of this class.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Event Dispatching

The Open Class Library dispatches events that have been sent or posted to a window to the handlers attached to that window. It does this by calling the event-dispatching function of the handler objects. An IEditHandler object processes only events related to changes to a window's value.


[view class]
dispatchHandlerEvent
protected:
virtual bool dispatchHandlerEvent(IEvent& event)

If an edit event is received, this function calls the appropriate virtual function.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Event Processing

An edit handler allows you to process changes to a window's value through its event-processing members. Override at least one of these virtual functions in a derived class.


[view class]
edit
protected:
virtual bool edit(IControlEvent& event) = 0

Implemented by the derived classes to process input changes to a window.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


IEditHandler - Inherited Member Functions and Data

Inherited Public Functions

IHandler

Inherited Public Data

Inherited Protected Functions

IHandler

Inherited Protected Data