### ICnrDrawBackgroundEvent

  The ICnrDrawBackgroundEvent class provides the information necessary to draw the background of the container. This event is not dispatched unless one of the following occurs:

  - The IContainerControl::handleDrawBackground style is set when the container is created.
  - The IContainerControl::enableDrawBackground function is called after construction.

#### AIX Considerations

  The Motif container widget does not support owner drawing of the container background. This event is not dispatched on AIX.

#### Windows Considerations

  The native Windows containers (that is, containers constructed without the pmCompatible style) do not support owner drawing of the container background. This event is not used in this case.

### ICnrDrawBackgroundEvent - Member Functions and Data by Group

### Constructors & Destructor

You can construct and destruct objects of this class.

~ICnrDrawBackgroundEvent

      public:
      virtual ~ICnrDrawBackgroundEvent()

Supported Platforms

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

ICnrDrawBackgroundEvent

      public:
      ICnrDrawBackgroundEvent(const IEvent& event)

  Although you can create objects of this class, typically ICnrDrawHandler::dispatchHandlerEvent creates them from an IControlEvent object in response to a background draw request.

Supported Platforms

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

### Event Information

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

container

      public:
      virtual IContainerControl* container() const

  Returns the container being drawn.

Supported Platforms

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

itemId

      public:
      virtual unsigned long itemId() const

  Returns the ID of the window to be painted.

Supported Platforms

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

itemPresSpaceHandle

      public:
      virtual IPresSpaceHandle itemPresSpaceHandle() const

  Returns the handle of the graphics drawing port for the window.

Supported Platforms

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

itemRect

      public:
      virtual IRectangle itemRect() const

  Returns the rectangle of the background in window coordinates.

Supported Platforms

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

### ICnrDrawBackgroundEvent - 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( 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(const IEvent& event)

  -     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