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.

Member Functions Documentation

CalChangeNotification(RArray< TCalChangeEntry > &)

voidCalChangeNotification(RArray< TCalChangeEntry > &aChangeItems)[pure virtual]

A call back function for change notification.

Parameters

RArray< TCalChangeEntry > & aChangeItemsList 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.