The IControlEvent class represents a notification event from a control. Many control event handler classes, such as IEditHandler, construct and process objects of this class. These notification events are first dispatched to the handlers attached to the control itself, then to the handlers attached to the owner window of the control.
An IControlEvent encapsulates various widget callbacks and certain X events.
An IControlEvent encapsulates the Presentation Manager message WM_CONTROL.
You can construct, destruct, and copy objects of this class.
Typically, a handler object, in its dispatchHandlerEvent function, constructs an IControlEvent object from an IEvent object. The handler then passes the IControlEvent object to one of its virtual functions. For example, the class IEditHandler constructs an IControlEvent, which it passes to its edit function.
![]() |
public:
virtual ~IControlEvent()
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
IControlEvent(const IControlEvent& event)
Create an IControlEvent from another IControlEvent object.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
public:
IControlEvent(const IEvent& event)
Create an IControlEvent from a generic IEvent object.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
Use these members to query information about the control that the event was generated from.
![]() |
public:
virtual unsigned long controlId() const
Returns the window ID of the control the event applies to.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
virtual ~IEvent()
IWindowHandle controlHandle() const
virtual IWindow* controlWindow() const
IEvent& decrementOwnerLevels()
virtual IWindow* dispatchingWindow() const
unsigned long eventId() const
IWindowHandle handle() const
IEvent(const IEvent& event)
IEvent( const IWindowHandle& handle, unsigned long eventId, const IEventParameter1& parameter1, const IEventParameter2& parameter2 )
IEvent( IWindow* window, unsigned long eventId, const IEventParameter1& parameter1, const IEventParameter2& parameter2 )
IEvent& operator =(const IEvent& event)
IEventParameter1 parameter1() const
IEventParameter2 parameter2() const
bool passToOwner() const
IEventResult result() const
IEvent& setControlHandle(const IWindowHandle& handle)
IEvent& setDispatchingHandle(const IWindowHandle& handle)
IEvent& setDispatchingWindow(IWindow* window)
IEvent& setHandle(const IWindowHandle& handle)
IEvent& setNumberOfLevels(int levels = - 1)
IEvent& setPassToOwner(bool passOn = true)
IEvent& setResult(bool eventResult)
IEvent& setResult(const IEventResult& eventResult)
virtual IWindow* window() const