MVPbkContactViewObserver Class Reference

class MVPbkContactViewObserver

An observer interface for contact views.

A client will receive events related to the view state and the view content via this interface. CVPbkContactManager::CreateContactViewLC

Constructor & Destructor Documentation

~MVPbkContactViewObserver()

~MVPbkContactViewObserver()[protected, inline, virtual]

Member Functions Documentation

ContactAddedToView(MVPbkContactViewBase &, TInt, const MVPbkContactLink &)

voidContactAddedToView(MVPbkContactViewBase &aView,
TIntaIndex,
const MVPbkContactLink &aContactLink
)[pure virtual]

Called when a contact has been added to the view.

Parameters

MVPbkContactViewBase & aViewA contact view sending the event.
TInt aIndexAn index of the contact in the view.
const MVPbkContactLink & aContactLinkA link to the added contact that is valid only during the functio call.

ContactRemovedFromView(MVPbkContactViewBase &, TInt, const MVPbkContactLink &)

voidContactRemovedFromView(MVPbkContactViewBase &aView,
TIntaIndex,
const MVPbkContactLink &aContactLink
)[pure virtual]

Called when a contact has been removed from a view.

Parameters

MVPbkContactViewBase & aViewA contact view sending the event.
TInt aIndexAn index of the removed contact.
const MVPbkContactLink & aContactLinkA link to the removed contact that is valid only during this function call.

ContactViewError(MVPbkContactViewBase &, TInt, TBool)

voidContactViewError(MVPbkContactViewBase &aView,
TIntaError,
TBoolaErrorNotified
)[pure virtual]

Called when an error occurs in the view.

If client decides to destroy the view then it should do it asynchronously because the view can access member data after a call to this.

Parameters

MVPbkContactViewBase & aViewA contact view sending the event.
TInt aErrorAn error code of the failure.
TBool aErrorNotifiedETrue if the implementation has already notified user about the error using e.g an ECOM plug-in, EFalse otherwise.

ContactViewObserverExtension(TUid)

TAny *ContactViewObserverExtension(TUid)[inline, virtual]

Returns an extension point for this interface or NULL.

Parameters

TUid

ContactViewReady(MVPbkContactViewBase &)

voidContactViewReady(MVPbkContactViewBase &aView)[pure virtual]

Called when a view is ready for use.

This function may also be called if view is already ready. Then it means that the view has been updated and the observer have to take this into account.

Parameters

MVPbkContactViewBase & aViewA contact view sending the event.

ContactViewUnavailable(MVPbkContactViewBase &)

voidContactViewUnavailable(MVPbkContactViewBase &aView)[pure virtual]

Called when a view is unavailable for a while.

When the view is again available ContactViewReady will be called. The contents of the view may change completely while it is unavailable.

Parameters

MVPbkContactViewBase & aViewA contact view sending the event.