### IControlEvent

  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.

#### AIX Considerations

  An IControlEvent encapsulates various widget callbacks and certain X events.

#### OS/2 Considerations

  An IControlEvent encapsulates the Presentation Manager message WM_CONTROL.

### IControlEvent - Member Functions and Data by Group

### Constructors & Destructor

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.

~IControlEvent

      public:
      virtual ~IControlEvent()

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

IControlEvent

  Overload 1

      public:
      IControlEvent(const IControlEvent& event)

  Create an IControlEvent from another IControlEvent object.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

  Overload 2

      public:
      IControlEvent(const IEvent& event)

  Create an IControlEvent from a generic IEvent object.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Event Information

Use these members to query information about the control that the event was generated from.

controlId

      public:
      virtual unsigned long controlId() const

  Returns the window ID of the control the event applies to.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### IControlEvent - Inherited Member Functions and Data

#### Inherited Public Functions

  IEvent

  -     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

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  - None

#### Inherited Protected Data

  - None