phonebookui/Phonebook2/remotecontactlookup/contactactionmenu/inc/cfsccontactactionmenuimpl.h
changeset 0 e686773b3f54
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook2/remotecontactlookup/contactactionmenu/inc/cfsccontactactionmenuimpl.h	Tue Feb 02 10:12:17 2010 +0200
@@ -0,0 +1,266 @@
+/*
+* Copyright (c) 2008 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:  Definition of the class CFscContactActionMenuImpl.
+*
+*/
+
+
+#ifndef C_FSCCONTACTACTIONMENUIMPL_H
+#define C_FSCCONTACTACTIONMENUIMPL_H
+
+#include <e32base.h>
+#include <coemain.h> 
+#include <eikcmobs.h>
+#include "cfsccontactactionmenu.h"
+#include "mfsccontactactionserviceobserver.h"
+
+// FORWARD DECLARATIONS
+class CFscContactActionMenuModelImpl;
+class CActiveSchedulerWait;
+class CTextResolver;
+class CFscContactActionMenuItem;
+class CAknStylusPopUpMenu;
+
+    
+/**
+ *  Contact Action Menu implementation.
+ *  Contains API that implements all the functionality of the Contact Action
+ *  Menu.
+ *
+ *  @lib fsccontactactionmenu.lib
+ *  @since S60 3.1
+ */
+
+class CFscContactActionMenuImpl 
+    : public CFscContactActionMenu,
+      public MCoeForegroundObserver,      
+      public MFscContactActionServiceObserver,      
+      public MEikMenuObserver
+    {
+    
+public: // Public constructors and destructor
+
+    /**
+     * Two-phased constructor.
+     *
+     * @param aParams Pointer construction parameters
+     * @return New instance of the component       
+     */
+    static CFscContactActionMenuImpl* NewL( TAny* aParams );
+   
+    /**
+     * Destructor.
+     */
+    virtual ~CFscContactActionMenuImpl();  
+    
+public: // From CFscContactActionMenu
+
+    /**
+     * Execute Action Menu
+     *   ExecuteL opens Action Menu with current item set. Method is
+     *   synchronous and it will return when Action Menu is closed.
+     *
+     * @param aPosition Vertical position where menu is to be openned
+     * @param aIndex Index of focused/highlighted item when menu is opened
+     * @return Execution result
+     */
+    TFscActionMenuResult ExecuteL( 
+        TFscContactActionMenuPosition aPosition = EFscCenter, TInt aIndex = 0, MFsActionMenuPositionGiver* aPositionGiver = 0 );
+
+    /**
+     * Dismiss menu
+     *   Menu gets closed if it was visible when the method was called. 
+     *   Otherwise method call does not do anything
+     *
+     * @param aSlide If ETrue menu slides away from the screen. 
+     *   Otherwise it disappears instantly
+     */
+    void Dismiss( TBool aSlide );  
+
+    /**
+     * Return a reference to Action Menu's model
+     * 
+     * @return Reference to menu model
+     */
+    MFscContactActionMenuModel& Model();
+  
+    /**
+     * Return index of selected item
+     * 
+     * @return index of selected item
+     */
+    TInt FocusedItemIndex();
+    
+    /**
+     * Return selected menu item object.
+     * 
+     * @return selected menu item object.
+     */
+    CFscContactActionMenuItem& FocusedItem();
+     
+     
+public: // From MCoeForegroundObserver
+    
+    /** 
+     * Handles the application coming to the foreground. 
+     */
+    void HandleGainingForeground();
+    
+    /** 
+     * Handles the application going into the background. 
+     */
+    void HandleLosingForeground();
+     
+public: // From MEikCommandObserver
+
+    /**
+     * ProcessCommandL
+     *
+     * @param aCommandId Command Id
+     */
+    void ProcessCommandL( TInt aCommandId );
+    
+protected: // From base class MFscContactActionServiceObserver
+    
+    /**
+     * From MFscContactActionServiceObserver.
+     * Called when QueryActionsL method is complete.
+     */
+    void QueryActionsComplete();
+        
+    /**
+     * From MFscContactActionServiceObserver.
+     * Called when QueryActionsL method failed.
+     * 
+     * @param aError An error code of the failure.
+     */
+    void QueryActionsFailed( TInt aError );
+    
+    /**
+     * From MFscContactActionServiceObserver.
+     * Called when ExecuteL method is complete.
+     */
+    void ExecuteComplete();
+       
+    /**
+     * From MFscContactActionServiceObserver.
+     * Called when ExecuteL method failed.
+     * 
+     * @param aError An error code of the failure.
+     */
+    void ExecuteFailed( TInt aError );
+    
+
+private: // Private constructors
+
+    /**
+     * Constructor.
+     *
+     * @param aParams Construction parameters
+     */
+    CFscContactActionMenuImpl( 
+        const TFscContactActionMenuConstructParameters& aParams );
+
+    /**
+     * Second phase constructor.
+     *
+     * @param aParams Construction parameters
+     */
+    void ConstructL(
+        const TFscContactActionMenuConstructParameters& aParams );
+
+private: // Private methods
+    /**
+    * Dismiss Action Menu
+    */
+    void DoDismiss();     
+    
+    void SetEmphasis(CCoeControl* aMenuControl,TBool aEmphasis);
+    
+    void DoLaunchStylusPopupL( const TPoint& aPoint );
+    
+    void CloseStylusPopup();
+    
+    void LaunchStylusPopupMenuL( const TPoint& aPoint );
+    
+    void DoExecuteL( MFsActionMenuPositionGiver* aPositionGiver );
+    
+    void HandleItemClick( TInt selectedItemIndex );
+    
+    void StartWait();
+    
+    void StopWait();
+
+private: // data
+
+    /**
+     * Menu model
+     *  Owned
+     */
+    CFscContactActionMenuModelImpl*    iModel;
+    
+    /**
+     * ExecuteL result code
+     */
+    TFscActionMenuResult               iMenuResult;
+ 
+    /**
+     * Selected item index
+     */
+    TInt                                iSelectedItemIndex;
+    
+    /**
+     * Error status while action menu is executed
+     */
+    TInt                                iError;
+    
+    /*
+     * Instant exit flag
+     */
+    TBool                               iExit;
+    /**
+     * Text resolver for resolving error texts
+     *  Owned
+     */
+    CTextResolver*                      iTextResolver;    
+    
+    
+    /**
+     * Is action execution finished?
+     */
+    TBool isExecuteCompleted;
+
+    /**
+     * Is action executing.
+     */
+    TBool iIsActionExecuting;    
+   
+    
+    /// Own: Stylus popup menu
+    CAknStylusPopUpMenu* iStylusPopup;
+    
+    /**
+     * Dummy item returned in case of error.
+     */
+    CFscContactActionMenuItem* iDummyMenuItem;
+    
+    /**
+     * Wait loop for ExecuteL
+     *  Owned
+     */
+    CActiveSchedulerWait* iWait;
+    };
+
+#endif // C_FSCCONTACTACTIONMENUIMPL_H
+