Collapse all Symbian^3 Application Developer Library

MCalChangeCallBack2 Class Reference

class MCalChangeCallBack2

A call back class for observing changes in the model view.

The call back returns an array containing information about at least one change to the database. The information includes the type of change and the identity of the item being changed.

A client will not be notified of a change if it is the source of the change.

Public Member Functions
void	CalChangeNotification ( RArray < TCalChangeEntry > &)

Public Member Enumerations
enum	TChangeEntryType { EChangeEntryTodo , EChangeEntryEvent , EChangeEntryAll }
enum	TChangeType { EChangeAdd , EChangeDelete , EChangeModify , EChangeUndefined , EChangeTzRules , EBackupStart , ERestoreStart , EBackupEnd , ERestoreEnd , ERestoredFileCanNotBeOpened }

Member Functions Documentation

CalChangeNotification(RArray< TCalChangeEntry > &)

void

CalChangeNotification

(

RArray < TCalChangeEntry > &

aChangeItems

)

[pure virtual]

A call back function for change notification.

Parameters

RArray < TCalChangeEntry > & aChangeItems

List of changes since the last notification.

Member Enumerations Documentation

Enum TChangeEntryType

Type of entry.

Enumerators

EChangeEntryTodo	Entry type is todo.
EChangeEntryEvent	Entry type is event.
EChangeEntryAll	All entry types.

Enum TChangeType

Type of change to the entry.

Enumerators

EChangeAdd	Calendar entry added.
EChangeDelete	Calendar entry deleted.
EChangeModify	Calendar entry modified.
EChangeUndefined	Undefined Calendar entry change.
EChangeTzRules	The time zone rules for one or more Calendar entries have changed.
EBackupStart	Backup Starts When the backup event is in process, the Calendar file is locked. Most of operations are not permitted when it happens. However, few operations, such as notification request, enabling broadcast and closing Calendar is still permitted.
ERestoreStart	Restore Starts When the restore event is in process, the Calendar file is locked. Most of operations are not permitted when it happens. However, few operations, such as notification request, enabling broadcast and closing Calendar is still permitted.
EBackupEnd	Backup Ends When the backup event is completed, the Calendar file is unlocked. The application can continue to operate on the current Calendar file.
ERestoreEnd	Restore Ends When the restore event is completed, the Calendar file is unlocked. The application can operate on the restored Calendar file after the application is notified with the message. However, if the application has cached any Calendar objects, such as Calendar file ID, Calendar entries, Calendar instances, they are not necessarily synched with the data in the newly restored Calendar file.
ERestoredFileCanNotBeOpened	The restored Calendar file can not be opened When the restore event is completed, the newly restored Calendar file can not be opened. It is because either the file version is not supported or the data is corrupted. Apart from closing the session and delete the file, no any other operation is permitted when it happens.