phonebookui/Phonebook2/UIControls/inc/CPbk2NamesListEmptyState.h
changeset 0 e686773b3f54
child 18 d4f567ce2e7c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook2/UIControls/inc/CPbk2NamesListEmptyState.h	Tue Feb 02 10:12:17 2010 +0200
@@ -0,0 +1,207 @@
+/*
+* 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 empty state.
+*
+*/
+
+
+#ifndef CPBK2NAMESLISTEMPTYSTATE_H
+#define CPBK2NAMESLISTEMPTYSTATE_H
+
+//  INCLUDES
+#include <e32base.h>
+#include "MPbk2NamesListState.h"
+#include <MPbk2CmdItemVisibilityObserver.h>
+
+// FORWARD DECLARATIONS
+class CPbk2ContactViewListBox;
+class CAknSearchField;
+class CPbk2ThumbnailLoader;
+
+// CLASS DECLARATION
+
+/**
+ * Phonebook 2 names list empty state.
+ * Responsible for:
+ * - implements names list control empty state
+ */
+NONSHARABLE_CLASS(CPbk2NamesListEmptyState) :
+        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 aFindBox          Reference to the find box.
+         * @param aThumbnailLoader  Thumbnail loader.
+         * @return  A new instance of this class.
+         */
+        static CPbk2NamesListEmptyState* NewLC(
+                const CCoeControl* aParent,
+                CPbk2ContactViewListBox& aListBox,
+                CAknSearchField* aFindBox,
+                CPbk2ThumbnailLoader& aThumbnailLoader,
+                RPointerArray<MPbk2UiControlCmdItem>& aCommandItems );  
+
+        /**
+         * Destructor.
+         */
+        ~CPbk2NamesListEmptyState();
+
+    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: // Implementation
+        void CmdItemVisibilityChanged( TInt aCmdItemId, TBool aVisible );  
+
+        CPbk2NamesListEmptyState(
+                const CCoeControl* aParent,
+                CPbk2ContactViewListBox& aListBox,
+                CAknSearchField* aFindBox,
+                CPbk2ThumbnailLoader& aThumbnailLoader,
+                RPointerArray<MPbk2UiControlCmdItem>& aCommandItems );	
+        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);  
+
+    private: // Data
+        /// Ref: Parent coecontrol
+        const CCoeControl& iParent;
+        /// Ref: The list box
+        CPbk2ContactViewListBox& iListBox;
+        /// Ref: The find box control
+        CAknSearchField* iFindBox;
+        /// Ref: Thumbnail loader
+        CPbk2ThumbnailLoader& iThumbnailLoader;
+        /// Ref: Command items
+        RPointerArray<MPbk2UiControlCmdItem>& iCommandItems;          
+    };
+
+#endif // CPBK2NAMESLISTEMPTYSTATE_H
+
+// End of File