phonebookui/Phonebook2/Presentation/inc/CPbk2ContactNameFormatterBase.h
changeset 0 e686773b3f54
child 32 2828b4d142c0
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook2/Presentation/inc/CPbk2ContactNameFormatterBase.h	Tue Feb 02 10:12:17 2010 +0200
@@ -0,0 +1,211 @@
+/*
+* 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:  A base class for contact name formatters
+*
+*/
+
+
+
+#ifndef CPBK2CONTACTNAMEFORMATTERBASE_H
+#define CPBK2CONTACTNAMEFORMATTERBASE_H
+
+//  INCLUDES
+#include <e32base.h>
+#include <MPbk2ContactNameFormatter.h>
+#include <MPbk2ContactNameFormatter2.h>
+
+#include "TPbk2SortOrderFieldMapper.h"
+
+// FORWARD DECLARATIONS
+class CPbk2SortOrderManager;
+class MVPbkFieldTypeList;
+class CVPbkFieldTypeRefsList;
+class CVPbkFieldTypeSelector;
+class TResourceReader;
+
+
+// CLASS DECLARATION
+
+/**
+*  A base class for contact name formatters
+*
+*/
+NONSHARABLE_CLASS( CPbk2ContactNameFormatterBase )
+        :   public CBase,
+            public MPbk2ContactNameFormatter,
+            public MPbk2ContactNameFormatter2
+    {
+    public:  // Constructors and destructor
+
+        /**
+        * Destructor.
+        */
+        virtual ~CPbk2ContactNameFormatterBase();
+
+    public: // Functions from MPbk2ContactNameFormatter
+
+        HBufC* GetContactTitleOrNullL(
+            const MVPbkBaseContactFieldCollection& aContactFields,
+            TUint32 aFormattingFlags);
+        HBufC* GetContactTitleL(
+           const MVPbkBaseContactFieldCollection& aContactFields,
+           TUint32 aFormattingFlags);
+        virtual void GetContactTitle(
+            const MVPbkBaseContactFieldCollection& aContactFields,
+            TDes& aTitle,
+            TUint32 aFormattingFlags) = 0;
+        virtual void GetContactTitleForFind(
+            const MVPbkBaseContactFieldCollection& aContactFields,
+            TDes& aTitle,
+            TUint32 aFormattingFlags) = 0;
+
+        const TDesC& UnnamedText() const;
+        TBool IsTitleField(
+            const MVPbkBaseContactField& aContactField) const;
+        TBool IsTitleFieldType(
+            const MVPbkFieldType& aFieldType) const;
+        virtual CVPbkBaseContactFieldTypeListIterator* ActualTitleFieldsLC(
+            CVPbkFieldTypeRefsList& aFieldTypeList,
+            const MVPbkBaseContactFieldCollection& aContactFields ) = 0;
+        virtual TInt MaxTitleLength(
+            const MVPbkBaseContactFieldCollection& aContactFields,
+            const TUint32 aFormattingFlags) = 0;
+        virtual TInt MaxTitleLengthForFind(
+            const MVPbkBaseContactFieldCollection& aContactFields,
+            const TUint32 aFormattingFlags) = 0;
+        virtual TBool IsFindSeparatorChar( TChar aCh ) = 0;
+        
+    public: // from MPbk2ContactNameFormatter2
+        virtual HBufC* GetContactTitleWithCompanyNameL(
+            const MVPbkBaseContactFieldCollection& aContactFields,
+            TUint32 aFormattingFlags ) = 0;
+        
+
+
+    protected:  // New functions
+
+        /**
+        * Field mapper returns fields from the given contact fields
+        * in the order defined by iSortOrderManager. Must be called
+        * from sub class functions
+        * @param aContactFields current fields
+        */
+        void SetFieldMapper(
+            const MVPbkBaseContactFieldCollection& aContactFields );
+
+        /**
+        * Get contact title according to given sort order positions
+        *
+        * @param aTitle a descriptor for adding data
+        * @param aFormattingFlags flags from the client
+        * @param aStartingPosition the index of the first type
+        *           in the sort order that is used for title
+        * @param aEndingPosition the index of the last type
+        *           in the sort order that is used for title
+        */
+        void DoGetContactTitle(
+            TDes& aTitle,
+            TUint32 aFormattingFlags,
+            const TInt aStartingPosition,
+            const TInt aEndingPosition);
+
+        /**
+        * Returns the maximum length of the title
+        *
+        * @param aFormattingFlags flags from the client
+        * @param aStartingPosition the index of the first type
+        *           in the sort order that is used for title
+        * @param aEndingPosition the index of the last type
+        *           in the sort order that is used for title
+        */
+        TInt DoCalculateMaxTitleLength(
+            const TUint32 aFormattingFlags,
+            const TInt aStartingPosition,
+            const TInt aEndingPosition);
+
+        /**
+        * Return non empty title field types
+        *
+        * @param aFieldTypeList target list where field types are appended
+        * @param aStartingPosition the index of the first type
+        *           in the sort order that is used for title
+        * @param aEndingPosition the index of the last type
+        *           in the sort order that is used for title
+        */
+        void DoAppendNonEmptyTitleFieldTypesL(
+            CVPbkFieldTypeRefsList& aFieldTypeList,
+            const TInt aStartingPosition,
+            const TInt aEndingPosition);
+        
+        /**
+        * Check if title fields are empty
+        *
+        * @param aStartingPosition the index of the first type
+        *           in the sort order that is used for title
+        * @param aEndingPosition the index of the last type
+        *           in the sort order that is used for title
+        * @return ETrue if title fields are empty else EFalse
+        */    
+        TBool AreTitleFieldsEmpty(
+            const TInt aStartingPosition,
+            const TInt aEndingPosition ) const;            
+
+    protected:
+
+        /**
+        * C++ default constructor.
+        */
+        CPbk2ContactNameFormatterBase(
+            const MVPbkFieldTypeList& aMasterFieldTypeList,
+            const CPbk2SortOrderManager& aSortOrderManager);
+
+        /**
+        * By default Symbian 2nd phase constructor is protected.
+        */
+        void BaseConstructL( const TDesC& aUnnamedText,
+            CVPbkFieldTypeSelector* aTitleFieldSelector );
+
+
+    private:    // Implementation
+        TBool RequiresSeparatorBetweenNames(
+            const TDesC& aLhs,
+            const TDesC& aRhs) const;
+        void TakePartOfName(
+            const MVPbkBaseContactField* aField,
+            TDes& aTitle,
+            const TUint32 aFormattingFlags,
+            const TBool aUseSeparator) const;
+        void CalculatePartOfName(
+            const MVPbkBaseContactField* aField,
+            TInt& aLength,
+            const TUint32 aFormattingFlags,
+            const TBool aUseSeparator) const;
+
+    protected: // Data
+        /// Own: Field mapper
+        TPbk2SortOrderFieldMapper iFieldMapper;
+
+    private:    // Data
+        const MVPbkFieldTypeList& iMasterFieldTypeList;
+        /// Ref: Sort order manager
+        const CPbk2SortOrderManager& iSortOrderManager;
+        /// Own: Text for unnamed contacts
+        HBufC* iUnnamedText;
+        /// Own: Title field selector
+        CVPbkFieldTypeSelector* iTitleFieldSelector;
+    };
+
+#endif      // CPBK2CONTACTNAMEFORMATTERBASE_H
+
+// End of File