Class TContactViewEvent

class TContactViewEvent;

Description

Identifies a contact view event.

Sent by contact views when notifying their observers of an event.

Members

Defined in TContactViewEvent:

• EGroupChangedA change has occurred in a contact group, for instance a contact item has been moved into or out of the group
• EIndexingErrorAn error occurred when setting the range for a CContactSubView
• EItemAddedAn item has been added to the observed view
• EItemRemovedAn item has been removed from the observed view
• EReadyThe observed view's state has changed from ENotReady or EInitializing to EReady so is available for use
• EServerErrorAn error occurred in the contacts server
• ESortErrorAn error occurred when sorting the observed view or when appending an observer to its observer array
• ESortOrderChangedThe observed view's sort order has changed, so observer views need to update themselves
• EUnavailableThe observed view's state has changed from EReady to either ENotReady or EInitializing, so is not available for use
• TContactViewEvent()Empty default constructor
• TContactViewEvent()Constructor with an event type and an optional error code and contact item ID
• TEventTypeIdentifies the event's type
• iContactIdThe ID of the contact item that has been added or removed or the group ID, where relevant
• iEventTypeThe type of event
• iIntThe error code (where relevant) or the index of the contact item added to/removed from the underlying view

See also:

• MContactViewObserver::HandleContactViewEvent()Handles an event in an observed contact view

inline TContactViewEvent();

Description

Empty default constructor.

inline TContactViewEvent(TEventType aEventType, TInt aInt=KErrUnknown, TContactItemId aContactId=KErrUnknown);

Description

Constructor with an event type and an optional error code and contact item ID.

Parameters

TEventType aEventType The event type. TInt aInt Optional standard error code. TContactItemId aContactId Optional contact item ID.

TEventType

Description

Identifies the event's type.

EUnavailable The observed view's state has changed from EReady to either ENotReady or EInitializing, so is not available for use. EReady The observed view's state has changed from ENotReady or EInitializing to EReady so is available for use. ESortOrderChanged The observed view's sort order has changed, so observer views need to update themselves. ESortError An error occurred when sorting the observed view or when appending an observer to its observer array. The error code is provided in iInt. EServerError An error occurred in the contacts server. The error code is provided in iInt. EIndexingError An error occurred when setting the range for a CContactSubView. The error code is provided in iInt. EItemAdded An item has been added to the observed view. The ID of the added item is provided in iContactId and the index into the observed view of the added item is provided in iInt. Exception from this are the first version of CContactFindView, CContactSubView and CContactGroupView classes. For these classes, iInt has KErrNone value EItemRemoved An item has been removed from the observed view. The ID of the removed item is provided in iContactId and the index into the observed view of the item is provided in iInt. Exception from this are the first version of CContactFindView and CContactSubView classes. For these classes, iInt has KErrNone value EGroupChanged A change has occurred in a contact group, for instance a contact item has been moved into or out of the group. The ID of the group affected is provided in iContactId.

TEventType iEventType;

Description

The type of event.

TInt iInt;

Description

The error code (where relevant) or the index of the contact item added to/removed from the underlying view.

TContactItemId iContactId;

Description

The ID of the contact item that has been added or removed or the group ID, where relevant.