ICnrDrawItemEvent

The ICnrDrawItemEvent class provides the information necessary to draw objects in the container. This event is dispatched when one of the following occurs:

AIX Considerations

The Motif container widget do not support owner drawing of container objects. 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 container objects. This event is not used in this case.


ICnrDrawItemEvent - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class.


[view class]
~ICnrDrawItemEvent
public:
virtual ~ICnrDrawItemEvent()

Supported Platforms

Windows OS/2 AIX
Yes Yes Ignored


[view class]
ICnrDrawItemEvent
public:
ICnrDrawItemEvent(const IEvent& event)

You can only construct objects of this class from an IEvent object. See IEvent for information about that class. Although you can create objects of this class, typically ICnrDrawHandler::dispatchHandlerEvent creates them from an IControlEvent object in response to a item 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.


[view class]
column
public:
virtual IContainerColumn* column() const

If an object or column title is being drawn in the details view, the column is returned. If the view is other than details view, 0 is returned.

Supported Platforms

Windows OS/2 AIX
Yes Yes Ignored


[view class]
container
public:
virtual IContainerControl* container() const

Returns the container holding the object being drawn.

Supported Platforms

Windows OS/2 AIX
Yes Yes Ignored


[view class]
itemPresSpaceHandle
public:
virtual IPresSpaceHandle itemPresSpaceHandle() const

Returns the handle of the graphics drawing port for the item being drawn.

Supported Platforms

Windows OS/2 AIX
Yes Yes Ignored


[view class]
itemRect
public:
virtual IRectangle itemRect() const

Returns the rectangle of the item's size.

Supported Platforms

Windows OS/2 AIX
Yes Yes Ignored


[view class]
itemType
public:
virtual ItemType itemType() const

Returns the type of the item being drawn.

Supported Platforms

Windows OS/2 AIX
Yes Yes Ignored


[view class]
object
public:
virtual IContainerObject* object() const

Returns the object being drawn. If the current view is details view and the column titles are being drawn, then 0 is returned.

Supported Platforms

Windows OS/2 AIX
Yes Yes Ignored


ICnrDrawItemEvent - Enumerations


[view class]
ItemType
enum ItemType { text, 
                icon, 
                treeIcon, 
                detailsView, 
                title }

Enumeration of the possible styles providing the type of the item being drawn:

text
The text in all views except the details view.
icon
An icon in the icon, name or tree view.
treeIcon
An expanded or collapsed tree icon.
detailsView
Any drawing in the details view.
title
The container title.

Supported Platforms

Windows OS/2 AIX
Yes Yes Ignored


ICnrDrawItemEvent - Inherited Member Functions and Data

Inherited Public Functions

IControlEvent
IDrawItemEvent
IEvent

Inherited Public Data

Inherited Protected Functions

IDrawItemEvent

Inherited Protected Data