MVPbkContactViewObserver Class Reference

#include <app/MVPbkContactViewObserver.h>

Link against: contactservice.lib

class MVPbkContactViewObserver
Public Member Functions
pure virtual voidContactAddedToView(MVPbkContactViewBase &, TInt, const MVPbkContactLink &)
pure virtual voidContactRemovedFromView(MVPbkContactViewBase &, TInt, const MVPbkContactLink &)
pure virtual voidContactViewError(MVPbkContactViewBase &, TInt, TBool)
virtual TAny *ContactViewObserverExtension(TUid)
pure virtual voidContactViewReady(MVPbkContactViewBase &)
pure virtual voidContactViewUnavailable(MVPbkContactViewBase &)
Protected Member Functions
virtual ~MVPbkContactViewObserver()

Detailed Description

An observer interface for contact views.

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

See also: CVPbkContactManager::CreateContactViewLC

Constructor & Destructor Documentation

~MVPbkContactViewObserver ( )

~MVPbkContactViewObserver()[protected, inline, virtual]

Member Function 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.

ParameterDescription
aViewA contact view sending the event.
aIndexAn index of the contact in the view.
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.

ParameterDescription
aViewA contact view sending the event.
aIndexAn index of the removed contact.
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.

ParameterDescription
aViewA contact view sending the event.
aErrorAn error code of the failure.
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.

Returns: an extension point for this interface or NULL.

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.

ParameterDescription
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.

ParameterDescription
aViewA contact view sending the event.