Share via


IVoIPDisplayItem (Windows Embedded CE 6.0)

1/6/2010

This interface defines a base class from which all the PhCommon display items are derived. Several classes internal to PhCommon inherit and build off of this base class to provide display item functionality that is exposed through APIs such as PHCreateTextDisplayItem and PHCreateLabeledEditDisplayItem.

This base class, itself, is not implemented and used directly. It serves only as a template. The custom listbox control implemented by PhCommon does not know how to draw any of its list items. Instead, clients fill the listbox with custom IVoIPDisplayItem objects. These objects contain all the information necessary to draw and position themselves in the area given to them by the listbox.

The PhCommon library source is included in this release and is considered sample code. So you are free to explore the library and this class in greater depth and free to modify it to fit your own programming needs.

Methods

Like all COM interfaces, this interface inherits the methods for the IUnknown interface. The following table shows the methods for this interface.

Method Description

IVoIPDisplayItem::Draw

Draws the item into the specified rectangle with the specified Device Context.

IVoIPDisplayItem::SetText

Sets the main text of the item.

IVoIPDisplayItem::GetText

Gets the main text from the item.

IVoIPDisplayItem::GetSubItemText

Gets the text of a specified sub item in the control.

IVoIPDisplayItem::GetHeight

Returns item height, if the item must size itself.

IVoIPDisplayItem::NeedsToolTip

Determines if this Display Item needs a tooltip.

IVoIPDisplayItem::IsSelectable

Determines if this Display Item is selectable.

Requirements

Header displayitem.hpp
Library PhCommon.dll
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

PhCommon Controls APIs
PhCommon Reference