--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook2/inc/CPbk2ContactViewBuilder.h Wed Sep 01 12:29:52 2010 +0100
@@ -0,0 +1,176 @@
+/*
+* 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 view builder.
+*
+*/
+
+
+#ifndef CPBK2CONTACTVIEWBUILDER_H
+#define CPBK2CONTACTVIEWBUILDER_H
+
+// INCLUDE FILES
+#include <e32base.h>
+#include <Pbk2ContactView.hrh>
+
+// FORWARD DECLARATIONS
+class CVPbkContactManager;
+class CVPbkContactViewDefinition;
+class MVPbkContactViewBase;
+class CPbk2StorePropertyArray;
+class CVPbkContactStoreUriArray;
+class MVPbkContactViewObserver;
+class MVPbkFieldTypeList;
+class CVPbkFieldTypeSelector;
+class MVPbkContactSelector;
+
+// CLASS DECLARATION
+
+/**
+ * Phonebook 2 contact view builder.
+ */
+class CPbk2ContactViewBuilder : public CBase
+ {
+ public: // Construction and destruction
+
+ /**
+ * Creates a new instance of this class.
+ *
+ * @param aContactManager Virtual Phonebook contact manager.
+ * @param aStoreProperties Store property array.
+ * @return A new instance of this class.
+ */
+ IMPORT_C static CPbk2ContactViewBuilder* NewLC(
+ CVPbkContactManager& aContactManager,
+ CPbk2StorePropertyArray& aStoreProperties );
+
+ /**
+ * Destructor.
+ */
+ ~CPbk2ContactViewBuilder();
+
+ public: // Interface
+
+ /**
+ * Creates a contact view for the stores specified in the
+ * given array.
+ *
+ * @param aUriArray Array of URIs of stores to include
+ * in the view.
+ * @param aObserver Observer for the view.
+ * @param aSortOrder Sort order for the view.
+ * @param aFilter Field type selector used to filter the view.
+ * @param aFlags TVPbkContactViewFlag flags for view modifying
+ * @return The contact view.
+ */
+ IMPORT_C MVPbkContactViewBase* CreateContactViewForStoresLC(
+ const CVPbkContactStoreUriArray& aUriArray,
+ MVPbkContactViewObserver& aObserver,
+ const MVPbkFieldTypeList& aSortOrder,
+ CVPbkFieldTypeSelector* aFilter,
+ TUint32 aFlags ) const;
+
+ /**
+ * Creates a contact view for the stores specified in the
+ * given array.
+ *
+ * @param aUriArray Array of URIs of stores to include
+ * in the view.
+ * @param aObserver Observer for the view.
+ * @param aSortOrder Sort order for the view.
+ * @param aFilter Field type selector used to filter the view.
+ * @param aFlags TVPbkContactViewFlag flags for view modifying
+ * @param aContactSelector Filter for contacts
+ * @return The contact view.
+ */
+ IMPORT_C MVPbkContactViewBase* CreateContactViewForStoresLC(
+ const CVPbkContactStoreUriArray& aUriArray,
+ MVPbkContactViewObserver& aObserver,
+ const MVPbkFieldTypeList& aSortOrder,
+ CVPbkFieldTypeSelector* aFilter,
+ TUint32 aFlags,
+ MVPbkContactSelector* aContactSelector ) const;
+
+ /**
+ * Creates a TOP-NON-TOP contact view for the stores specified in the
+ * given array.
+ *
+ * @param aUriArray Array of URIs of stores to include
+ * in the view.
+ * @param aObserver Observer for the view.
+ * @param aSortOrder Sort order for the view.
+ * @param aFilter Field type selector used to filter the view.
+ * @param aContactSelector A contact selector.
+ * @return The contact view.
+ */
+ IMPORT_C MVPbkContactViewBase* CreateTopNonTopContactViewForStoresLC(
+ const CVPbkContactStoreUriArray& aUriArray,
+ MVPbkContactViewObserver& aObserver,
+ const MVPbkFieldTypeList& aSortOrder,
+ CVPbkFieldTypeSelector* aFilter,
+ TUint32 aFlags,
+ MVPbkContactSelector& aContactSelector ) const;
+
+ /**
+ * Creates a group view for the stores specified in the
+ * given array.
+ *
+ * @param aUriArray Array of URIs of stores to include
+ * in the view.
+ * @param aObserver Observer for the view.
+ * @param aSortOrder Sort order for the view.
+ * @param aFilter Field type selector used to filter the view.
+ * @param aFlags TVPbkContactViewFlag flags for view modifying
+ * @return The contact view.
+ */
+ IMPORT_C MVPbkContactViewBase* CreateGroupViewForStoresLC(
+ const CVPbkContactStoreUriArray& aUriArray,
+ MVPbkContactViewObserver& aObserver,
+ const MVPbkFieldTypeList& aSortOrder,
+ CVPbkFieldTypeSelector* aFilter,
+ TUint32 aFlags ) const;
+
+ private: // Implementation
+ CPbk2ContactViewBuilder(
+ CVPbkContactManager& aContactManager,
+ CPbk2StorePropertyArray& aStoreProperties );
+ CVPbkContactViewDefinition* BuildMainViewStructureLC(
+ CVPbkFieldTypeSelector* aFilter,
+ TUint32 aFlags ) const;
+ MVPbkContactViewBase* CreateViewForStoresLC(
+ TPbk2ContactViewType aViewType,
+ const CVPbkContactStoreUriArray& aUriArray,
+ MVPbkContactViewObserver& aObserver,
+ const MVPbkFieldTypeList& aSortOrder,
+ CVPbkFieldTypeSelector* aFilter,
+ TUint32 aFlags,
+ TBool aTopContacts = EFalse,
+ MVPbkContactSelector* aContactSelector = NULL) const;
+ static TBool IncludeThisViewInTopContactMode(
+ TPbk2ContactViewType aViewType );
+ void SetTopRelatedFilteringL(
+ CVPbkContactViewDefinition& aNewSubViewDef,
+ TPbk2ContactViewType aViewType,
+ CVPbkFieldTypeSelector* aFilter ) const;
+
+ private: // Data
+ /// Ref: Virtual Phonebook contact manager
+ CVPbkContactManager& iContactManager;
+ /// Ref: Store property array
+ CPbk2StorePropertyArray& iStoreProperties;
+ mutable MVPbkContactSelector* iContactSelector; // Does not own
+ };
+
+#endif // CPBK2CONTACTVIEWBUILDER_H
+
+// End of File