| 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 } |
| void | CalChangeNotification | ( | RArray< TCalChangeEntry > & | aChangeItems | ) | [pure virtual] |
A call back function for change notification.
| RArray< TCalChangeEntry > & aChangeItems | List of changes since the last notification. |
Type of entry.
| EChangeEntryTodo |
Entry type is todo. |
| EChangeEntryEvent |
Entry type is event. |
| EChangeEntryAll |
All entry types. |
Type of change to the entry.
| 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. |