### ICnrEnterEvent

  The ICnrEnterEvent class retrieves information about a container enter event. Objects of this class are dispatched when an enter event occurs in the container. This can be as a result of the following:

  - The Enter key is pressed.
  - A double-click of the mouse select button occurred.

### ICnrEnterEvent - Member Functions and Data by Group

### Constructors & Destructor

You can construct and destruct objects of this class.

~ICnrEnterEvent

      public:
      virtual ~ICnrEnterEvent()

Supported Platforms

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

ICnrEnterEvent

      public:
      ICnrEnterEvent(const IControlEvent& event)

  Although you can construct objects of this class, typically ICnrHandler::dispatchHandlerEvent creates objects of this class from an object of the class IControlEvent in response to the user pressing the Enter key or double-clicking the mouse select button.

Supported Platforms

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

### Event Information

Use these members to query and set the accessible attributes of this class.

enterPressed

      public:
      bool enterPressed() const

  If the event is the result of pressing the Enter key, true is returned. Otherwise, the event occurred because the mouse select button was double-clicked.

Supported Platforms

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

object

      public:
      IContainerObject* object() const

  Returns the object over which the enter occurred. If the enter did not occur on an object, 0 is returned.

Supported Platforms

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

validObject

      public:
      bool validObject() const

  If the event occurred over an object, true is returned.

Supported Platforms

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

### ICnrEnterEvent - Inherited Member Functions and Data

#### Inherited Public Functions

  ICnrEvent

  -     virtual ~ICnrEvent()

  -     ICnrEvent(const IControlEvent& event)

  IControlEvent

  -     virtual ~IControlEvent()

  -     virtual unsigned long controlId() const

  -     IControlEvent(const IEvent& event)

  -     IControlEvent(const IControlEvent& event)

  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( IWindow* window,
                unsigned long eventId,
                const IEventParameter1& parameter1,
                const IEventParameter2& parameter2 )

  -     IEvent( const IWindowHandle& handle,
                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

  ICnrEvent

  -     unsigned long containerId() const

#### Inherited Protected Data

  - None