--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook2/inc/Pbk2AddressTools.h	Wed Sep 01 12:29:52 2010 +0100
@@ -0,0 +1,145 @@
+/*
+* Copyright (c) 2005-2007 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:  Phonebook 2 contact address tools.
+*
+*/
+
+#ifndef PBK2ADDRESSTOOLS_H
+#define PBK2ADDRESSTOOLS_H
+
+#include "TPbk2ContactEditorParams.h"
+#include <Pbk2FieldProperty.hrh>
+#include <VPbkFieldType.hrh>
+#include <MVPbkFieldType.h>
+#include <e32hashtab.h>
+
+class MVPbkStoreContact;
+
+class Pbk2AddressTools
+	{
+public:
+	 /**
+	 * Maps UI contol type to feld group
+	 *
+	 * @param aCtrlType  Type of control ( TPbk2FieldCtrlTypeExt )
+	 * @return Suitable gruup id ( TPbk2FieldGroupId )
+	 */
+	IMPORT_C static TPbk2FieldGroupId MapCtrlTypeToAddress( 
+			TInt aCtrlType );
+	
+	 /**
+	 * Maps UI view type  to feld group
+	 *
+	 * @param aViewType  Type of view
+	 * @return Suitable gruup id
+	 */
+	IMPORT_C static TPbk2FieldGroupId MapViewTypeToAddress( 
+			TPbk2ContactEditorParams::TActiveView aViewType );
+	
+	/**
+	 * Maps feld group to field ordering
+	 *
+	 * @param aGroupAddress  field group
+	 * @return Suitable field ordering
+	 */
+	IMPORT_C static TInt MapAddressToOrdering( 
+			TPbk2FieldGroupId aGroupAddress );
+	
+	/**
+	 * Maps feld group to field ordering
+	 *
+	 * @param aGroupAddress  field group
+	 * @return Suitable field ordering
+	 */
+	IMPORT_C static TPbk2ContactEditorParams::TActiveView MapCtrlTypeToViewType( 
+			TInt aCtrlType );
+	
+	/**
+	 * Maps feld group to field type parameter
+	 *
+	 * @param aGroupAddress  field group
+	 * @return Suitable field type parameter
+	 */
+	IMPORT_C static TVPbkFieldTypeParameter MapAddressToVersitParam( 
+			TPbk2FieldGroupId aGroupId );
+	
+	/**
+	 * Creates map field type parameters to text data from these fields
+	 *
+	 * @param aContact  contact
+	 * @param aAddressGroup  field group
+	 * @param aFieldsMap  return parameter, allocated and put on CleanapStack
+	 * 					  	
+	 */
+	IMPORT_C static void GetAddressFieldsLC(
+				MVPbkStoreContact& aContact, 
+				TPbk2FieldGroupId aAddressGroup, 
+				RHashMap<TInt, TPtrC>& aFieldsMap );
+	
+	/**
+	* Creates address preview text from QTN_PHOB_ADDRESS_PREVIEW
+	* or QTN_PHOB_CONTACT_EDITOR_DEFINE if suitable fields are empty
+	*
+	* @param aContact  contact
+	* @param aAddressGroup  field group
+	* @param aFieldsMap  return parameter, allocated and put on CleanapStack
+	* 					  	
+	*/
+	IMPORT_C static void GetAddressPreviewLC(
+			MVPbkStoreContact& aContact, 
+			TPbk2FieldGroupId aAddressGroup, 
+			RBuf& aText );
+	
+	/**
+	* Creates address preview text from qtn_phob_commlauncher_onelinepreview  
+	* or QTN_PHOB_POPUP_INCOMPLETE_ADDRESS if suitable fields are empty
+	*
+	* @param aContact  contact
+	* @param aAddressGroup  field group
+	* @param aFieldsMap  return parameter, allocated and put on CleanapStack
+	* 					  	
+	*/
+	IMPORT_C static void GetAddressShortPreviewLC(
+				MVPbkStoreContact& aContact, 
+				TPbk2FieldGroupId aAddressGroup, 
+				RBuf& aText );
+	
+	 /**
+	 * Maps VPbkFieldType to field group
+	 *
+	 * @param aVPbkFieldType  Type of virtual phonebook field type
+	 * @return Suitable group id ( TPbk2FieldGroupId )
+	 */
+	IMPORT_C static TPbk2FieldGroupId MapVPbkFieldTypeToAddressGroupId( 
+			const MVPbkFieldType* aVPbkFieldType );
+	
+	 /**
+	 * Judge whether the address preview of one contact is empty
+	 * Address preview include the following four fields: 
+	 * EVPbkVersitSubFieldStreet, EVPbkVersitSubFieldLocality, 
+	 * EVPbkVersitSubFieldRegion and EVPbkVersitSubFieldCountry.
+	 * If the four fields are all empty, return ETrue; Otherwise, return EFalse.
+	 *
+	* @param aContact  contact
+	* @param aAddressGroup  field group
+	* @return If address preview is empty, return ETrue; Otherwiase, EFalse
+	 */
+	IMPORT_C static TBool IsAddressPreviewEmptyL( 
+			MVPbkStoreContact& aContact,
+			TPbk2FieldGroupId aAddressGroup );
+	};
+
+#endif // PBK2ADDRESSTOOLS_H
+            
+// End of File