--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/emailcontacts/remotecontactlookup/engine/inc/cpbkxrclcontactupdater.h Thu Dec 17 08:39:21 2009 +0200
@@ -0,0 +1,143 @@
+/*
+* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "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:
+*
+* Description: Definition of the class CPbkxRclContactUpdater
+*
+*/
+
+
+#ifndef CPBKXRCLCONTACTUPDATER_H
+#define CPBKXRCLCONTACTUPDATER_H
+
+#include <e32base.h>
+
+class CPbkContactEngine;
+class CPbkContactItem;
+class TPbkContactItemField;
+class CPbkFieldInfo;
+
+/**
+* Class that updates existing contact data.
+*
+* @lib pbkxrclengine.lib
+* @since 3.1
+*/
+class CPbkxRclContactUpdater : public CBase
+ {
+public: // constructors and destructor
+
+ /**
+ * Constructs contact updater.
+ *
+ * @param aEngine Contact engine.
+ * @return Created object.
+ */
+ static CPbkxRclContactUpdater* NewL( CPbkContactEngine& aEngine );
+
+ /**
+ * Constructs contact updater.
+ *
+ * Pointer to the created object is left on cleanupstack.
+ *
+ * @param aEngine Contact engine.
+ * @return Created object.
+ */
+ static CPbkxRclContactUpdater* NewLC( CPbkContactEngine& aEngine );
+
+ /**
+ * Destructor.
+ */
+ virtual ~CPbkxRclContactUpdater();
+
+public: // new methods
+
+ /**
+ * Updates the given field to the user selected contact.
+ *
+ * @param aField Field to be updated to the contact.
+ *
+ * @return Update text shown to the user. Ownership is transferred.
+ */
+ HBufC* UpdateContactL( TPbkContactItemField& aField );
+
+private: // methods used internally
+
+ /**
+ * Constructs the list of possible fields and if there are several,
+ * user is asked to select a field.
+ *
+ * If there is already selected field, user is asked if he wants to
+ * replace the existing field.
+ *
+ * NULL is returned if user cancels the updating.
+ *
+ * @param aContactItem Contact for which field is updated.
+ * @param aFieldInfo Field info of the field which data is updated
+ * to the contact.
+ * @return Field which is updated.
+ */
+ TPbkContactItemField* SelectUpdatedFieldL(
+ CPbkContactItem& aContactItem,
+ CPbkFieldInfo& aFieldInfo );
+
+ /**
+ * Constructs update text shown to the user after successfull updating.
+ *
+ * @param aContactItem Contact item that was updated.
+ * @param aField Updated field.
+ * @return Update text.
+ */
+ HBufC* ConstructUpdatedTextL(
+ CPbkContactItem& aContactItem,
+ TPbkContactItemField& aField );
+
+ /**
+ * Constructs a list of possible fields of given type.
+ *
+ * There are three possible types: home, work, and none. If at least two
+ * types are found, user is asked to select a type.
+ *
+ * @param aFieldInfo Source field info of the field that is updated
+ * to the contact.
+ * @param aFieldCount Number of possible fields.
+ * @return Destination field info which is updated.
+ * Ownership is not transferred.
+ */
+ CPbkFieldInfo* SelectFieldL(
+ CPbkFieldInfo& aFieldInfo,
+ TInt& aFieldCount );
+
+private: // constructors
+
+ /**
+ * Constructor.
+ *
+ * @param aEngine Contact engine.
+ */
+ CPbkxRclContactUpdater( CPbkContactEngine& aEngine );
+
+ /**
+ * Second-phase constructor.
+ */
+ void ConstructL();
+
+private: // data
+
+ // Contact engine.
+ CPbkContactEngine& iEngine;
+ // Offset to resource file.
+ TInt iResourceFileOffset;
+ };
+
+#endif
+