--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/widgetmanager/inc/wmmaincontainer.h Thu Dec 17 08:40:49 2009 +0200
@@ -0,0 +1,398 @@
+/*
+* 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 CAknButton;
+class CCoeControl;
+class CAknSearchField;
+class CWmWidgetLoaderAo;
+
+/**
+ * Container class for WmMainContainer
+ *
+ * @class CWmMainContainer WmMainContainer.h
+ */
+NONSHARABLE_CLASS( CWmMainContainer ) : public CCoeControl,
+ public MEikListBoxObserver,
+ public MCoeControlObserver
+ {
+public: // constructors and destructor
+
+ /*
+ * Two-phased constructor.
+ *
+ * @param aRect container rect
+ * @param aParent control base class
+ * @param aCommandObserver observers respond to user commands
+ * @param aWmPlugin wm plugin
+ */
+ static CWmMainContainer* NewL(
+ const TRect& aRect,
+ const CCoeControl* aParent,
+ MEikCommandObserver* aCommandObserver,
+ CWmPlugin& aWmPlugin );
+
+ /*
+ * Two-phased constructor.
+ *
+ * @param aRect container rect
+ * @param aParent control base class
+ * @param aCommandObserver observers respond to user commands
+ * @param aWmPlugin wm plugin
+ */
+ static CWmMainContainer* NewLC(
+ const TRect& aRect,
+ const CCoeControl* aParent,
+ MEikCommandObserver* aCommandObserver,
+ CWmPlugin& aWmPlugin );
+
+ /** Destructor */
+ virtual ~CWmMainContainer();
+
+private:
+ CWmMainContainer( CWmPlugin& aWmPlugin );
+
+ void ConstructL(
+ const TRect& aRect,
+ const CCoeControl* aParent,
+ MEikCommandObserver* aCommandObserver );
+
+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();
+
+ /**
+ * executes findbox deactivation
+ */
+ void DeactivateFindPaneL();
+
+ /**
+ * sorts the widget list in alphabetical order
+ */
+ void SortListAlphabeticallyL();
+
+ /**
+ * executes widget uninstall
+ */
+ void UninstallWidgetL();
+
+ /**
+ * opens OVI portal
+ */
+ void OpenOviPortalL();
+
+ /**
+ * 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 );
+
+ /**
+ * returns whether adding of widget was sucessful or not
+ */
+ TInt ExitStatus();
+
+ /**
+ * Sets the exit status to denote the failure or sucess of adding
+ * widget to homescreen
+ */
+ void SetExitStatus( TInt aExitStatus );
+
+ /**
+ * Moves focus to the OVI button
+ */
+ void SetFocusToOviButton();
+
+ /**
+ * 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 );
+
+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: // from MCoeControlObserver
+
+ /**
+ * Control observer interface
+ *
+ * @see MCoeControlObserver::HandleControlEventL
+ */
+ void HandleControlEventL(CCoeControl* aControl,TCoeEvent aEventType);
+
+private: // New functions
+
+ void AddControlL( CCoeControl* aControl, TInt aControlId );
+ void InitializeControlsL( const TRect& aRect );
+ void LayoutControlsL();
+ void StartLoadingWidgetsL();
+ void RemoveCtrlsFromStack();
+ TKeyResponse MoveFocusByKeys(
+ const TKeyEvent& aKeyEvent,
+ TEventCode aType );
+ void UpdateFocusMode();
+ CCoeControl* FindChildControlByPoint( const TPoint& aPoint );
+ void HandleFindSizeChanged();
+
+private:
+
+ /**
+ * the plugin root
+ */
+ CWmPlugin& iWmPlugin;
+
+ /**
+ * parent control
+ */
+ const CCoeControl* iParent;
+
+ /**
+ * the widgets list
+ */
+ CWmListBox* iWidgetsList;
+
+ /**
+ * search filed
+ */
+ CAknSearchField* iFindbox;
+
+ /**
+ * search filed visibility switch
+ */
+ TBool iFindPaneIsVisible;
+
+ /**
+ * background
+ */
+ CAknsBasicBackgroundControlContext* iBgContext;
+
+ /**
+ * Ovi portal
+ */
+ CAknButton* iOviPortal;
+
+ /** GUI layout modes */
+ enum TWmLayout
+ {
+ EPortrait,
+ ELandscape,
+ ELandscapeMirrored
+ };
+
+ /**
+ * current widget manager container layout
+ */
+ TWmLayout iLayout;
+
+ /** focus modes */
+ enum TWmFocusMode
+ {
+ ENowhere,
+ EOvi,
+ EList,
+ EFind
+ };
+
+ /**
+ * current widget manager focus mode
+ */
+ TWmFocusMode iFocusMode;
+
+ /**
+ * exit variable to denote sucess or failure of adding widget to hs
+ */
+ TInt iExitStatus;
+
+ /**
+ * 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;
+ };
+
+#endif // WMMAINCONTAINER_H
+
+// End of File