MCalChangeCallBack2 Class Reference

#include <app/calchangecallback.h>

Link against: calendarservice.lib

class MCalChangeCallBack2

Detailed Description

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 Enumeration Documentation

Enum TChangeEntryType

Type of entry.

EnumeratorValueDescription
EChangeEntryTodo

Entry type is todo.

EChangeEntryEvent

Entry type is event.

EChangeEntryAll

All entry types.

Enum TChangeType

Type of change to the entry.

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

Member Function Documentation

CalChangeNotification ( RArray< TCalChangeEntry > & )

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

A call back function for change notification.

ParameterDescription
aChangeItemsList of changes since the last notification.