Symbian3/SDK/Source/GUID-200BA7B9-70A1-5D15-8CFF-FBD18930757D.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Tue, 20 Jul 2010 12:00:49 +0100
changeset 13 48780e181b38
parent 0 89d6a7a84779
permissions -rw-r--r--
Week 28 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 1897 and Bug 1522.

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept xml:lang="en" id="GUID-200BA7B9-70A1-5D15-8CFF-FBD18930757D"><title>Change Notification</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>As data changes clients such as UI-level applications need to respond to the updates. The Contacts Model calls a Change Notifier class (<xref href="GUID-140725B3-8D52-3D2B-9E72-CAF76962B95A.dita"><apiname>CContactChangeNotifier</apiname></xref>) which allows clients to receive notification of changes made to contact items. Change events are sent in the order that they occur. </p> <p>Change event details are contained in <xref href="GUID-AC58DE73-3BD6-31CC-8CD3-31260A325B24.dita"><apiname>TContactDbObserverEvent</apiname></xref> and include: </p> <ul><li id="GUID-E5357DFB-C0D5-5DFF-9F23-C887121E5904"><p>Changes to a contact item, template, group or own card </p> </li> <li id="GUID-61FE83A9-EBA3-5BE9-92EA-DA9172C44605"><p>Recovery from a damaged database </p> </li> <li id="GUID-768035B9-F035-56A2-ABBF-37C80D988D4A"><p>Rollback from a change to the database has completed </p> </li> <li id="GUID-6075E47F-C74C-5F8E-AFC4-6703BF268BD1"><p>Changes to the current database </p> </li> <li id="GUID-3FC6D932-5E0F-52FE-8E5A-3B0A27731F78"><p>Changes to Speed Dials </p> </li> <li id="GUID-9451A48E-71F3-59C4-ADAC-9A4778477955"><p>Changes to the sort order of a contact list </p> </li> </ul> <p>Each notification event specifies the UID of the contact changed, and of the client who made the change (to allow clients to ignore their own changes). </p> </conbody></concept>