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 Motif container widget does not support owner drawing of the container background. This event is not dispatched on AIX.
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.
You can construct and destruct objects of this class.
![]() |
public:
virtual ~ICnrDrawBackgroundEvent()
Windows | OS/2 | AIX |
Yes | Yes | Ignored |
![]() |
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.
Windows | OS/2 | AIX |
Yes | Yes | Ignored |
Use these members to query and set the accessible attributes of this class.
![]() |
public:
virtual IContainerControl* container() const
Returns the container being drawn.
Windows | OS/2 | AIX |
Yes | Yes | Ignored |
![]() |
public:
virtual unsigned long itemId() const
Returns the ID of the window to be painted.
Windows | OS/2 | AIX |
Yes | Yes | Ignored |
![]() |
public:
virtual IPresSpaceHandle itemPresSpaceHandle() const
Returns the handle of the graphics drawing port for the window.
Windows | OS/2 | AIX |
Yes | Yes | Ignored |
![]() |
public:
virtual IRectangle itemRect() const
Returns the rectangle of the background in window coordinates.
Windows | OS/2 | AIX |
Yes | Yes | Ignored |
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