--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/contacts_plat/virtual_phonebook_engine_api/inc/CVPbkFieldFilter.h	Wed Sep 01 12:29:52 2010 +0100
@@ -0,0 +1,133 @@
+/*
+* Copyright (c) 2002-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 filtered and sorted collection of contact fields.
+*
+*/
+
+
+#ifndef CVPBKFIELDFILTER_H
+#define CVPBKFIELDFILTER_H
+
+// INCLUDES
+#include <e32base.h>
+#include <MVPbkStoreContactFieldCollection.h>
+
+// FORWARD DECLARATIONS
+class MVPbkContactFieldSelector;
+class MVPbkContactFieldOrdering;
+
+
+/**
+ * A filtered and sorted collection of Virtual Phonebook contact fields.
+ */
+class CVPbkFieldFilter : 
+        public CBase,
+        public MVPbkStoreContactFieldCollection
+    {
+    public:  // Types
+        /**
+         * CVPbkFieldFilter configuration. This configuration class is
+         * used to configure the field filter. 
+         */
+        class TConfig
+            {
+            public:
+	            /**
+	             * Constructor.
+	             *
+	             * @param aBaseFields	Mandatory base field set to filter.
+	             * @param aFieldSelector	Optional field selector instance.
+	             * @param aFieldOrdering	Optional field ordering instance.
+	             */
+	            inline TConfig (
+	            		MVPbkStoreContactFieldCollection& aBaseFields,
+	                	MVPbkContactFieldSelector* aFieldSelector = NULL,
+	                	MVPbkContactFieldOrdering* aFieldOrdering = NULL);
+
+			public:
+	            ///Ref: Base field collection that is filtered
+	            MVPbkStoreContactFieldCollection& iBaseFields;
+	            ///Ref: A field selector
+	            MVPbkContactFieldSelector* iFieldSelector;
+	            ///Ref: Field sorter
+	            MVPbkContactFieldOrdering* iFieldOrdering;
+	            ///Ref: Spare for future extension
+	            TAny* iSpare;
+            };
+
+    public:  // Constructor and Destructor
+        /**
+         * Creates and returns a new instance of this class.
+         *
+         * @param aConfig   Field filtering configuration.
+         */
+        IMPORT_C static CVPbkFieldFilter* NewL(const TConfig& aConfig);
+		
+		/**
+		 * Destructor.
+		 */
+        ~CVPbkFieldFilter();
+
+    public:  // Interface
+        /**
+         * Reset the contents of this filtered field collection according 
+         * to a new configuration.
+         *
+         * @param aConfig	Filtering configuration to rest to.
+         */
+        IMPORT_C void ResetL(const TConfig& aConfig);
+
+        /**
+         * Finds given field from the set of filtered fields
+         * @param aContactField	Field to search for.
+         * @return Index of the given field, or KErrNotFound if field is not found.
+         */
+        IMPORT_C TInt FindField(const MVPbkBaseContactField& aContactField) const;
+
+    public:  // from MVPbkStoreContactFieldCollection
+        MVPbkBaseContact& ParentContact() const;
+        TInt FieldCount() const;
+        const MVPbkStoreContactField& FieldAt(TInt aIndex) const;
+        MVPbkStoreContactField& FieldAt(TInt aIndex);
+        MVPbkStoreContactField* FieldAtLC(TInt aIndex) const;
+        MVPbkStoreContact& ParentStoreContact() const;
+        MVPbkStoreContactField* RetrieveField(
+                const MVPbkContactLink& aContactLink) const;
+            
+    private:  // Implementation
+        CVPbkFieldFilter();
+
+    private:  // Data
+        ///Ref: base fields
+        MVPbkStoreContactFieldCollection* iBaseFields;
+        ///Own: field mapping 
+        RArray<TInt> iFieldMapping;
+    };
+
+
+// INLINE FUNCTIONS
+
+inline CVPbkFieldFilter::TConfig::TConfig
+        (MVPbkStoreContactFieldCollection& aBaseFields,
+        MVPbkContactFieldSelector* aFieldSelector /*= NULL*/,
+        MVPbkContactFieldOrdering* aFieldOrdering /*= NULL*/) :
+    iBaseFields(aBaseFields),
+    iFieldSelector(aFieldSelector),
+    iFieldOrdering(aFieldOrdering)
+    {
+    }
+
+#endif  // CVPBKFIELDFILTER_H
+
+// End of file