EPOC   SDK Home Glossary Indexes Previous Next Up

MMsvEntryObserver class


Contents


MMsvEntryObserver class — Entry events notification

Section Contents


Overview

Compatibility

Applications that use this class will not work correctly on a version of EPOC earlier than ER5.

Derivation

Not applicable

Defined in

msvapi.h

Description

This mixin class 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().


Event handler


HandleEntryEvent() — Event handler

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

Description

The function is called by a CMsvEntry object to indicate 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.

Arguments

TMsvEntryEvent aEvent

Indicates the event type.

TAny* aArg1-3

Event-specific argument values


Enumerations


TMsvEntryEvent enum — Entry event type

EMsvEntryChanged

The entry has been changed, either as a result of a CMsvEntry::ChangeL() 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() 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().

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

EMsvStoreDeleted

The store associated with this entry has been deleted.

EMsvStoreCommitted

Changes to the store associated with this entry have been committed.

EMsvStoreCreated

A store associated with this entry has been created.

EMsvEntryMoved

The current entry has been moved by another client. The CMsvEntry has already been updated to reflect the new parent.

EPOC       SDK Home Glossary Indexes Previous Next Up