phonebookui/Phonebook2/UIControls/inc/CPbk2NamesListFilteredState.h
branchRCL_3
changeset 63 f4a778e096c2
child 64 c1e8ba0c2b16
child 85 38bb213f60ba
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook2/UIControls/inc/CPbk2NamesListFilteredState.h	Wed Sep 01 12:29:52 2010 +0100
@@ -0,0 +1,247 @@
+/*
+* 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 names list filtered state.
+*
+*/
+
+#ifndef CPBK2NAMESLISTFILTEREDSTATE_H
+#define CPBK2NAMESLISTFILTEREDSTATE_H
+
+//  INCLUDES
+#include <e32base.h>
+#include "MPbk2NamesListState.h"
+#include <MPbk2CmdItemVisibilityObserver.h>
+#include <coecobs.h>
+#include <badesca.h>
+
+// FORWARD DECLARATIONS
+class CPbk2ContactViewListBox;
+class MPbk2FilteredViewStack;
+class CAknSearchField;
+class MPbk2UiControlEventSender;
+class MPbk2Command;
+class MPbk2ContactNameFormatter;
+class CPbk2FindStringSplitter;
+class CPbk2AdaptiveSearchGridFiller;
+class CPbk2PredictiveSearchFilter;
+
+// CLASS DECLARATION
+
+/**
+ * Phonebook 2 names list filtered state.
+ */
+NONSHARABLE_CLASS(CPbk2NamesListFilteredState) :
+        public CBase,
+            public MPbk2NamesListState,
+            public MPbk2CmdItemVisibilityObserver 
+    {
+    public:  // Constructors and destructor
+        /**
+         * Creates a new instance of this class.
+         *
+         * @param aParent       Parent control.
+         * @param aListBox      Reference to the list box.
+         * @param aViewStack    A view stack for find box input.
+         * @param aFindBox      FindPane Control
+         * @param aEventSender          UI control event sender.
+         * @param aNameFormatter Phonebook 2 contact name formatter interface
+         * @param aSearchFilter PBk2 Search Filter
+         * @param aCommandItems Command items possibly shown as nameslist content
+         * @return A new instance of this class.
+         */
+        static CPbk2NamesListFilteredState* NewLC(
+                const CCoeControl* aParent,
+                CPbk2ContactViewListBox& aListBox,
+                MPbk2FilteredViewStack& aViewStack,
+                CAknSearchField* aFindBox,
+                MPbk2UiControlEventSender& aEventSender,                
+                MPbk2ContactNameFormatter& aNameFormatter,
+                CPbk2PredictiveSearchFilter& aSearchFilter,
+                RPointerArray<MPbk2UiControlCmdItem>& aCommandItems );  
+
+        /**
+         * Destructor.
+         */
+        ~CPbk2NamesListFilteredState();
+
+    public: // From MPbk2NamesListState
+        void ActivateStateL();
+        void DeactivateState();
+        TInt CountComponentControls() const;
+        CCoeControl* ComponentControl(
+                TInt aIndex ) const;
+        void SizeChanged();
+        void MakeComponentsVisible(
+                TBool aVisible );
+        void ActivateL();
+        void Draw(
+                const TRect& aRect,
+                CWindowGc& aGc ) const;
+        TKeyResponse OfferKeyEventL(
+                const TKeyEvent& aKeyEvent,
+                TEventCode aType );
+        void HandlePointerEventL(
+                const TPointerEvent& aPointerEvent );
+        TInt NamesListState() const;
+        void HandleContactViewEventL(
+                TInt aEvent,
+                TInt aIndex );
+        void HandleCommandEventL(TInt aEvent, TInt aListboxIndex);                
+        CCoeControl& CoeControl();
+        void HandleControlEventL(
+                CCoeControl* aControl,
+                MCoeControlObserver::TCoeEvent aEventType, TInt aParam );
+        const MVPbkViewContact* TopContactL();
+
+    public: // From MPbk2ContactUiControl
+        MPbk2ContactUiControl* ParentControl() const;
+        TInt NumberOfContacts() const;
+        const MVPbkBaseContact* FocusedContactL() const;
+        const MVPbkViewContact* FocusedViewContactL() const;
+        const MVPbkStoreContact* FocusedStoreContact() const;
+        void SetFocusedContactL(
+                const MVPbkBaseContact& aContact );
+        void SetFocusedContactL(
+                const MVPbkContactBookmark& aContactBookmark );
+        void SetFocusedContactL(
+                const MVPbkContactLink& aContactLink );
+        TInt FocusedContactIndex() const;
+        void SetFocusedContactIndexL(
+                TInt aIndex );
+        TInt NumberOfContactFields() const;
+        const MVPbkBaseContactField* FocusedField() const;
+        TInt FocusedFieldIndex() const;
+        void SetFocusedFieldIndex( TInt aIndex );
+        TBool ContactsMarked() const;
+        MVPbkContactLinkArray* SelectedContactsL() const;
+        MVPbkContactLinkArray* SelectedContactsOrFocusedContactL() const;
+        MPbk2ContactLinkIterator* SelectedContactsIteratorL() const;
+        CArrayPtr<MVPbkContactStore>* SelectedContactStoresL() const;
+        void ClearMarks();
+        void SetSelectedContactL(
+                TInt aIndex,
+                TBool aSelected );
+        void SetSelectedContactL(
+                const MVPbkContactBookmark& aContactBookmark,
+                TBool aSelected );
+        void SetSelectedContactL(
+                const MVPbkContactLink& aContactLink,
+                TBool aSelected );
+        
+        void DynInitMenuPaneL(
+                TInt aResourceId,
+                CEikMenuPane* aMenuPane ) const;
+        void ProcessCommandL(
+                TInt aCommandId ) const;
+        void UpdateAfterCommandExecution();
+        TInt GetMenuFilteringFlagsL() const;
+        CPbk2ViewState* ControlStateL() const;
+        void RestoreControlStateL(
+                CPbk2ViewState* aState );
+        const TDesC& FindTextL();
+        void ResetFindL();
+        void HideThumbnail();
+        void ShowThumbnail();
+        void SetBlank( TBool aBlank );
+        void RegisterCommand(
+                MPbk2Command* aCommand );
+        void SetTextL(
+                const TDesC& aText );
+        TAny* ContactUiControlExtension(TUid aExtensionUid );
+
+public: // From MPbk2ContactUiControl2        
+        TInt CommandItemCount() const;
+        const MPbk2UiControlCmdItem& CommandItemAt( TInt aIndex ) const;
+        const MPbk2UiControlCmdItem* FocusedCommandItem() const;
+        void DeleteCommandItemL( TInt aIndex );
+        void AddCommandItemL(MPbk2UiControlCmdItem* aCommand, TInt aIndex);
+        
+    public: // From MPbk2PointerEventInspector
+        TBool FocusedItemPointed();
+        TBool FocusableItemPointed();
+        TBool SearchFieldPointed();
+        
+    public: // From MPbk2FilteredViewStackObserver
+        void TopViewChangedL( MVPbkContactViewBase& aOldView );
+        void TopViewUpdatedL();
+        void BaseViewChangedL();
+        void ViewStackError( TInt aError );
+        void ContactAddedToBaseView(
+                MVPbkContactViewBase& aBaseView, TInt aIndex,
+                const MVPbkContactLink& aContactLink );        
+
+
+    private: // From MPbk2CmdItemVisibilityObserver
+        void CmdItemVisibilityChanged( TInt aCmdItemId, TBool aVisible );  
+
+    private:  // Implementation
+        CPbk2NamesListFilteredState(
+                const CCoeControl* aParent,
+                CPbk2ContactViewListBox& aListBox,
+                MPbk2FilteredViewStack& aViewStack,
+                CAknSearchField* aFindBox,
+                MPbk2UiControlEventSender& aEventSender,                
+                MPbk2ContactNameFormatter& aNameFormatter,
+                CPbk2PredictiveSearchFilter& aSearchFilter,
+                RPointerArray<MPbk2UiControlCmdItem>& aCommandItems );	
+        void ConstructL();
+        void HandleFocusChangeL();                                  
+        void UpdateFindResultL();
+        void UpdateAdaptiveSearchGridL();
+        TBool IsContactAtListboxIndex( TInt aListboxIndex ) const;	
+        void AllowCommandsToShowThemselves( TBool aVisible );  	    
+        void UpdateCommandEnabled(TInt aCommandId, TBool aEnabled);	
+        void UnmarkCommands() const;								
+        TBool IsCommandEnabled( TInt aCommandId) const;				
+        TInt FindCommand(TInt aCommandId) const;					
+        TInt CalculateListboxIndex(TInt aCommandIndex) const;       
+        void UnsubscribeCmdItemsVisibility() const;					
+        void SubscribeCmdItemsVisibility();							
+        void HandleListboxEventL(TInt aEvent, TInt aListboxIndex, TBool aMantainFocus);
+        TInt EnabledCommandCount() const; 
+
+    private: // Data
+        /// Ref: Parent coecontrol
+        const CCoeControl& iParent;
+        /// Ref: The list box
+        CPbk2ContactViewListBox& iListBox;
+        /// Own: Buffer for text retrieved from iFindBox
+        HBufC* iFindTextBuf;
+        /// Ref: A stack of control's VPbk views.
+        MPbk2FilteredViewStack& iViewStack;
+        /// Ref: Find box control
+        CAknSearchField* iFindBox;
+        /// Ref: UI control event sender
+        MPbk2UiControlEventSender& iEventSender;	
+        /// Ref: Search field indicator
+        TBool iSearchFieldPointed;
+        /// Ref: command in execution
+        MPbk2Command* iCommand;
+        /// Ref: Name formatter
+        MPbk2ContactNameFormatter& iNameFormatter;
+        /// Own: Array of search strings
+        MDesCArray* iStringArray;
+        /// Own: String splitter
+        CPbk2FindStringSplitter* iStringSplitter;
+        /// Own: User to create keymaps for adaptive search grid.
+        CPbk2AdaptiveSearchGridFiller *iAdaptiveSearchGridFiller;
+        ///Ref : Search Pane Filter
+        CPbk2PredictiveSearchFilter& iSearchFilter;
+        /// Ref: Command items
+        RPointerArray<MPbk2UiControlCmdItem>& iCommandItems;  	        
+    };
+
+#endif // CPBK2NAMESLISTFILTEREDSTATE_H
+
+// End of File