idlehomescreen/widgetmanager/inc/wmmaincontainer.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 12 Mar 2010 15:41:49 +0200
branchRCL_3
changeset 11 ff572dfe6d86
parent 9 f966699dea19
child 12 9674c1a575e9
permissions -rw-r--r--
Revision: 201007 Kit: 201008

/*
* Copyright (c) 2009 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:
* Declares main container control for Widget Manager application.
*
*/

#ifndef WMMAINCONTAINER_H
#define WMMAINCONTAINER_H

#include <e32base.h>
#include <e32cmn.h>
#include <f32file.h>
#include <coecobs.h>
#include <coecntrl.h>
#include <AknsUtils.h>
#include <gulicon.h>
#include <eiklbo.h>  // MEikListBoxObserver

// FORWARD DECLARATIONS
class CWmPlugin;
class CWmListBox;
class CAknsBasicBackgroundControlContext;
class CAknViewAppUi;
class CAknSearchField;
class CCoeControl;
class CAknSearchField;
class CWmPortalButton;
class CWmWidgetLoaderAo;
class CWmMainContainerView;
class CWmConfiguration;

/**
 * Container class for WmMainContainer
 * 
 * @class	CWmMainContainer WmMainContainer.h
 */
NONSHARABLE_CLASS( CWmMainContainer ) : public CCoeControl,
                                        public MEikListBoxObserver
	{
public: // constructors and destructor
	
    /*
     * Two-phased constructor.
     * 
     * @param aRect container rect
     * @param aWmPlugin wm plugin
     */
	static CWmMainContainer* NewL( 
		const TRect& aRect,
		CWmPlugin& aWmPlugin );

    /*
     * Two-phased constructor.
     * 
     * @param aRect container rect
     * @param aWmPlugin wm plugin
     */
	static CWmMainContainer* NewLC( 
		const TRect& aRect,
		CWmPlugin& aWmPlugin );	

	 /** Destructor */
	virtual ~CWmMainContainer();
	
private:
    /** constructor */
	CWmMainContainer(
	    CWmPlugin& aWmPlugin );
    
    /** 2nd phase constructor */
    void ConstructL( 
            const TRect& aRect );

public: // new functions	

    /** 
     * @return true, if portal button is currently selected 
     */
    TBool PortalSelected();
    
    /** 
     * @return true, if a widget in list is currently selected 
     */
    TBool WidgetSelected();
    
    /** 
     * @return true, ADD command is possible
     */
    TBool CanDoAdd(); 
    
    /** 
     * @return true, if UNINSTALL command is possible
     */
    TBool CanDoUninstall();
    
    /** 
     * @return true, if LAUNCH command is possible
     */
    TBool CanDoLaunch();

    /**
     * @return true, if FIND command is possible
     */
    TBool CanDoFind();
    
    /**
     * @return true, if SORT command is possible
     */
    TBool CanDoSort();
    
    /**
     * @return true, if DETAILS command is possible
     */
    TBool CanDoDetails();
    
    /**
     * @return true, if HELP command is possible
     */
    TBool CanDoHelp();
    
    /** 
     * executes widget details dialog launch 
     */
    void LaunchDetailsDialogL();

    /** 
	 * executes widget addition to home screen 
	 */
	void AddWidgetToHomeScreenL();
	
	/** 
	 * executes widget launch 
	 */
	void LaunchWidgetL();
	
	/** 
	 * executes findbox activation 
	 */
	void ActivateFindPaneL( TBool aActivateAdabtive = EFalse );

    /** 
	 * executes findbox deactivation 
	 */
    void DeactivateFindPaneL();
	
    /** 
     * sorts the widget list in alphabetical order
     */
    void SortListAlphabeticallyL();

	/** 
	 * executes widget uninstall 
	 */
	void UninstallWidgetL();

    /**
     * opens currently selected portal
     */
    void OpenPortalL();

    /**
     * Selection key (middle soft key)
     */
    void SelectL();
    
    /**
     * Show widget manager help
     */
    void ShowHelpL();

    /** 
     * handles situation when widget list has changed.
     * in practice reloads the widget list from the widgets API
     * and redraws the screen.
     */
	void HandleWidgetListChanged();

public:

    /**
     * Handles key events.
     * 
     * @see CCoeControl::OfferKeyEventL
     */
	TKeyResponse OfferKeyEventL( 
			const TKeyEvent& aKeyEvent, 
			TEventCode aType );
	
	/**
	 * Handles a change to the control's resources
	 * 
	 * @see CCoeControl::HandleResourceChange
	 */
	void HandleResourceChange( TInt aType );
	
	/**
	 * Handles pointer events.
	 * 
	 * @see CCoeControl::HandlePointerEventL
	 */
	void HandlePointerEventL( const TPointerEvent& aPointerEvent );
	
	/**
	 * Moves focus to the OVI button
	 * @param aIndex 0=first button, 1=second (if it exists)
	 */
    void SetFocusToPortalButton( TInt aIndex );

    /**
     * Moves focus to the widgets list, alternatively also setting the currently
     * selected item.
     * @param aIndex the item in widgets list to highlight during setting focus.
     *        By default the previously selected item will be highlighted.
     */
    void SetFocusToWidgetList( TInt aIndex = KErrUnknown );

    /*
     * Tells if user inputs should be handeled or not. If ret is EFalse wm 
     * can ignore user inputs. This is becouse closing view is async and user
     * might give some inputs before view is closed. 
     */
    TBool ClosingDown();
        
    /*
     * To set iClosingDown. See above.
     */
    void SetClosingDown( TBool aClosingDown );

    /**
     * access to WM configuration
     */
    CWmConfiguration& Configuration();
    
    /**
     * Process foregound events.
     * @param aForeground ETrue indicates foreground
     */
    void ProcessForegroundEvent( TBool aForeground );
    
protected: // from base class CCoeControl
    
    /**
     * Sets the control's extent, specifying a rectangle.
     * 
     * @see CCoeControl::SizeChanged
     */
    void SizeChanged();

private: // from base class CCoeControl

    /*
     * Draws the control.
     * 
     * @see CCoeControl::Draw
     */
    void Draw( const TRect& aRect ) const;
    
    /**
    * Suppy Mop object for control context
    * @param TTypeUid aId
    */
    TTypeUid::Ptr MopSupplyObject(TTypeUid aId);

private: // from MEikListBoxObserver

    /**
     * List box observer interface.
     * 
     * @see MEikListBoxObserver::HandleListBoxEventL
     */
    void HandleListBoxEventL(
                        CEikListBox* aListBox,
                        TListBoxEvent aEventType);

private: // New functions
    
    void AddControlL( CCoeControl* aControl, TInt aControlId );
    void InitializeControlsL( const TRect& aRect );
    void LayoutControls();
    void StartLoadingWidgetsL();
    void RemoveCtrlsFromStack();
    void UpdateFocusMode();
    CCoeControl* FindChildControlByPoint( const TPoint& aPoint );
    void HandleFindSizeChanged();
    TKeyResponse MoveFocusByKeys(
            const TKeyEvent& aKeyEvent, 
            TEventCode aType );
    TKeyResponse HandleButtonKeyEventL( 
            const TKeyEvent& aKeyEvent, 
            TEventCode aType );
    TKeyResponse HandleListKeyEventL( 
            const TKeyEvent& aKeyEvent, 
            TEventCode aType );
    TKeyResponse HandleSearchKeyEventL( 
            const TKeyEvent& aKeyEvent, 
            TEventCode aType );
private:

    /**
     * the plugin root
     */
    CWmPlugin&              iWmPlugin;

    /**
     * the widgets list
     */
    CWmListBox*             iWidgetsList;

    /**
	 * search filed
	 */
    CAknSearchField* 		iFindbox;
    
    /**
	 * search filed visibility switch
	 */
    TBool            		iFindPaneIsVisible;
    
    /**
     * background
     */
    CAknsBasicBackgroundControlContext* iBgContext;
    
    /**
     * portal button
     * (if there is only one button, this is it)
     */
    CWmPortalButton*         iPortalButtonOne;

    /**
     * portal button
     * (if there is only one button, this is NULL)
     */
    CWmPortalButton*         iPortalButtonTwo;

    /** whether we are orientated in landscape */
    TBool                   iLandscape;

    /** whether we have mirrored layout */
    TBool                   iMirrored;

    /** focus modes */
    enum TWmFocusMode
        {
        ENowhere,
        EPortal,
        EList,
        EFind
        };

    /**
     * current widget manager focus mode
     */
    TWmFocusMode            iFocusMode;
    
    /**
     * AO for loading widgets into the list UI
     */
    CWmWidgetLoaderAo*      iWidgetLoader;
    
    /**
     * If this is set to ETrue it means wmview is closing and all user inputs
     * should be ignored.
     */
    TBool                   iClosingDown;
    
    /**
     * The configuration
     */
    CWmConfiguration*       iConfiguration;
    
#ifdef _WM_UNIT_TEST
    friend class CWmUnitTest;
#endif
    };

#endif // WMMAINCONTAINER_H

// End of File