Class MMsvEntryObserver

class MMsvEntryObserver;

Description

Provides the interface for notification of events associated with an entry.

The types of event are given in the enumeration TMsvEntryEvent. Clients can provide an object that implements the interface, and set it to be notified through CMsvEntry::AddObserverL(MMsvEntryObserver &).

Members

Defined in MMsvEntryObserver:

• EMsvChildrenChangedOne or more of the children have been changed. aArg1 points to a CMsvEntrySelect...
• EMsvChildrenInvalidAn error has occurred such that the status of the children is unknown and probab...
• EMsvChildrenMissingSome new children have been created, but CMsvEntry was unable to retrieve the da...
• EMsvContextInvalidThe context has become invalid. The entry has been changed, but the CMsvEntry wa...
• EMsvDeletedChildrenChildren have been deleted. aArg1 points to a CMsvEntrySelection contain the ID ...
• EMsvEntryChangedThe entry has been changed, either as a result of a CMsvEntry::ChangeL(const TMs...
• EMsvEntryDeletedThe entry has been deleted by another client. The context is now invalid.
• EMsvEntryMovedThe current entry has been moved by another client. The CMsvEntry has already be...
• EMsvNewChildrenNew children have been created. aArg1 points to a CMsvEntrySelection contain the...
• HandleEntryEventL(TMsvEntryEvent,TAny *,TAny *,TAny *)Indicates when called by a CMsvEntry object that an event has occurred.
• TMsvEntryEventDefines entry event types.

virtual void HandleEntryEventL(TMsvEntryEvent aEvent, TAny *aArg1, TAny *aArg2, TAny *aArg3)=0;

Description

Indicates when called by a CMsvEntry object that an event has occurred.

The type of event is indicated by the value of aEvent. The interpretation of the aArg1-3 values depends on this type. For most event types, the action that is taken, for example, updating the display, is client-specific. Most clients will need to handle events that make the current context invalid: EMsvContextInvalid and EMsvEntryDeleted.

An implementation can leave if an error occurs. The leave is not trapped by the framework, so the error code may be displayed to the user.

Parameters

MMsvEntryObserver::TMsvEntryEvent aEvent Indicates the event type. TAny *aArg1 Event-specific argument value TAny *aArg2 Event-specific argument value TAny *aArg3 Event-specific argument value

TMsvEntryEvent

Description

Defines entry event types.

EMsvEntryChanged The entry has been changed, either as a result of a CMsvEntry::ChangeL(const TMsvEntry &) or by another client. EMsvNewChildren New children have been created. aArg1 points to a CMsvEntrySelection contain the ID of the new children. EMsvDeletedChildren Children have been deleted. aArg1 points to a CMsvEntrySelection contain the ID of the deleted children. EMsvChildrenChanged One or more of the children have been changed. aArg1 points to a CMsvEntrySelection containing the IDs of the changed children. EMsvEntryDeleted The entry has been deleted by another client. The context is now invalid. EMsvContextInvalid The context has become invalid. The entry has been changed, but the CMsvEntry was unable to update the context. The context will only become valid by a successful CMsvEntry::SetEntryL(TMsvId) call. aArg1 points to a TInt containing the error code for the invalid context. EMsvChildrenMissing Some new children have been created, but CMsvEntry was unable to retrieve the data from the Message Server. The children will be correct only after a successful call to CMsvEntry::SetEntryL(TMsvId). EMsvChildrenInvalid An error has occurred such that the status of the children is unknown and probably invalid. aArg1 points to a TInt containing the error code for the invalid context EMsvEntryMoved The current entry has been moved by another client. The CMsvEntry has already been updated to reflect the new parent.