--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/iaupdate/IAD/ui/inc/iaupdateappui.h Thu Dec 17 08:51:10 2009 +0200
@@ -0,0 +1,445 @@
+/*
+* Copyright (c) 2007-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: This file contains the header file of the CIAUpdateAppUi class
+*
+*/
+
+
+
+#ifndef __IAUPDATE_APPUI_H__
+#define __IAUPDATE_APPUI_H__
+
+//INCLUDES
+#include <e32base.h>
+#include <aknViewAppUi.h>
+#include <cmmanagerext.h>
+
+#include "iaupdateuidefines.h"
+#include "iaupdateuicontrollerobserver.h"
+#include "iaupdatedialogutil.h"
+#include "iaupdateuitimerobserver.h"
+
+// FORWARD DECLARATIONS
+class CIAUpdateMainView;
+class CIAUpdateHistoryView;
+class CIAUpdateUiController;
+class CIAUpdateParameters;
+class MIAUpdateRequestObserver;
+class CIAUpdateGlobalLockHandler;
+class CIAUpdateUITimer;
+
+/*!
+@class CIAUpdateAppUi
+
+An instance of class CIAUpdateAppUi is the UserInterface part of the AVKON
+application framework for the IAUpdate example application
+*/
+class CIAUpdateAppUi :
+ public CAknViewAppUi,
+ public MIAUpdateUiControllerObserver,
+ public MIAUpdateTextLinkObserver,
+ public MIAUpdateUITimerObserver
+ {
+public:
+
+ /*
+ * Perform the second phase construction of a CIAUpdateAppUi object
+ * this needs to be public due to the way the framework constructs the AppUi
+ */
+ void ConstructL();
+
+ /*!
+ * Perform the first phase of two phase construction.
+ * This needs to be public due to the way the framework constructs the AppUi
+ */
+ CIAUpdateAppUi();
+
+
+ /*
+ * Destroy the object and release all memory objects
+ */
+ virtual ~CIAUpdateAppUi();
+
+ void StartedByLauncherL( MIAUpdateRequestObserver& aObserver,
+ TBool aRefreshFromNetworkDenied );
+
+ /**
+ * When the update check operation is started through
+ * the API, the session directs the requests for the UI. UI will
+ * handle the operation and inform the observer when the operation is
+ * completed.
+ * @param aObserver This observer is informed when the operation has
+ * been completed.
+ * @param aFilterParams These parameters are used when update items
+ * are filtered for the UI list.
+ */
+ void CheckUpdatesRequestL( MIAUpdateRequestObserver& aObserver,
+ CIAUpdateParameters* aFilterParams );
+
+ /**
+ * When the show update operation is started through
+ * the API, the session directs the requests for the UI. UI will
+ * hanle the operation and inform the observer when the operation is
+ * completed.
+ * @param aObserver This observer is informed when the operation has
+ * been completed.
+ * @param aFilterParams These parameters are used when update items
+ * are filtered for the UI list.
+ */
+ void ShowUpdatesRequestL( MIAUpdateRequestObserver& aObserver,
+ CIAUpdateParameters* aFilterParams );
+
+
+
+ /**
+ * When the update operation is started through
+ * the API, the session directs the requests for the UI. UI will
+ * hanle the operation and inform the observer when the operation is
+ * completed.
+ * @param aObserver This observer is informed when the operation has
+ * been completed.
+ * @param aUid Uid of the caller of the request
+ */
+ void ShowUpdateQueryRequestL( MIAUpdateRequestObserver& aObserver, TUint aUid );
+
+ /**
+ * Handle removal of observer
+ */
+ void HandleObserverRemoval();
+
+ /**
+ * Set this application visible/unvisible
+ * @param aVisible If EFalse application is put background and is hidden in FSW
+ */
+ void SetVisibleL( TBool aVisible );
+
+ /**
+ * Show status dialog of update
+ */
+ void ShowStatusDialogL();
+
+ /**
+ * Starts CIdle. Status dialog is shown in callback function.
+ */
+ void ShowStatusDialogDeferredL();
+
+ /**
+ * Get CIAUpdateUiController instance
+ * @return Returns pointer of iController
+ */
+ CIAUpdateUiController* Controller() const;
+
+ /**
+ * Performs cancel depending on ongoing request and state
+ */
+ void PotentialCancel();
+
+ /**
+ * Set ordinal position to foreground and
+ * set iClientMovedToBackground to EFalse
+ */
+ void HandleClientToForegroundL();
+
+ /**
+ * Handle situation when iaupdate.exe leaves running although
+ * client session has been closed
+ */
+ void HandleAllClientsClosedL();
+
+ /**
+ * Indicates whether Status dialog to be shown or not when history view is deactivated
+ *
+ * @return ETrue when status dialog to be re-shown
+ */
+ TBool ShowStatusDialogAgain() const;
+
+ /**
+ * Starts monitoring of window group list changes
+ */
+ void StartWGListChangeMonitoring();
+
+ /**
+ * Stops monitoring of window group list changes
+ */
+ void StopWGListChangeMonitoring();
+
+ /**
+ * Set window group id of client application
+ *
+ * @param aWgId Window group id
+ */
+ void SetClientWgId( TInt aWgId );
+
+ /**
+ * Is client application in backround
+ *
+ * @param True value if client application is in background
+ */
+ TInt ClientInBackgroundL() const;
+
+
+ /**
+ * Set DM support
+ *
+ * @param True value if DM is supported
+ */
+ void SetDMSupport( TBool aDMSupport );
+
+ /**
+ * Check DM support
+ *
+ * @return True value if DM is supported
+ */
+ TBool IsDMSupport();
+
+ /**
+ * Check if DM support is set
+ *
+ * @return True value if DM support is set
+ */
+ TBool IsDMSupportSet();
+
+ /**
+ * Check if UI refresh allowed
+ *
+ * @return True value if UI refresh is allowed
+ */
+ TBool UiRefreshAllowed();
+
+
+private: // from CAknViewAppUi
+
+ /*!
+ * @function HandleCommandL
+ * @discussion Handle user menu selections
+ * @param aCommand the enumerated code for the option selected
+ */
+ void HandleCommandL( TInt aCommand );
+
+ /**
+ * Handle window server event
+ *
+ * @param aEvent The window server event that occurred
+ * @param aDestination The controller associated with the event
+ */
+ void HandleWsEventL( const TWsEvent& aEvent, CCoeControl* aDestination );
+
+
+private: // From MIAUpdateTextLinkObserver
+ void TextLinkL( TInt aLinkId );
+
+
+private: // From MIAUpdateUiControllerObserver
+ /**
+ * Called when async engine start-up is completed
+ *
+ * @param aError Error code
+ */
+ void StartupComplete( TInt aError );
+
+ /**
+ * Leaving method, called as trapped in StartupComplete
+ */
+ void StartupCompleteL();
+
+
+ /**
+ * Handles leave error.
+ *
+ * @param aError Error code
+ */
+ void HandleLeaveErrorL( TInt aError );
+
+ /**
+ * Handles leave error withot leaving
+ *
+ * @param aError Error code
+ */
+ void HandleLeaveErrorWithoutLeave( TInt aError );
+
+ /**
+ * Called when async update list refresh is completed
+ *
+ * @param aError Error code
+ */
+ void RefreshCompleteL( TBool aWithViewActivation, TInt aError );
+
+ /**
+ * Called when async updating is completed
+ *
+ * @param aError Error code
+ */
+ void UpdateCompleteL( TInt aError );
+
+ /**
+ * Choose a usable IAP from all SNAPs
+ *
+ * @param aCmManagerExt handle of connection manager
+ */
+ TUint32 GetBestIAPInAllSNAPsL( RCmManagerExt& aCmManagerExt );
+
+ /**
+ * Choose a usable IAP from Internet SNAP
+ *
+ * @param aCmManagerExt handle of connection manager
+ */
+ TUint32 GetBestIAPInInternetSNAPL( RCmManagerExt& aCmManagerExt );
+
+ /**
+ * Choose the best IAP under the given SNAP
+ *
+ * @param aCmManagerExt handle of connection manager
+ * @param aSNAP SNAP ID
+ */
+ TUint32 GetBestIAPInThisSNAPL( RCmManagerExt& aCmManagerExt, TUint32 aSNAP = 0);
+
+private: // from MIAUpdateUITimerObserver
+
+ virtual void BackgroundDelayComplete( TInt aError );
+
+ virtual void ForegroundDelayComplete( TInt aError );
+
+ virtual void ProcessStartDelayComplete( TInt aError );
+
+private: // new methods
+
+ /**
+ * Refreshes main view
+ * @param aError Error code
+ */
+ void RefreshL( TInt aError );
+
+ /**
+ * Informs an observer that its async request is completed
+ *
+ * @param aError Error code
+ */
+ void InformRequestObserver( TInt aError );
+
+ /**
+ * Sets the default connection method used for network access.
+ * Connection can be set as an accesspoint or as a snap for example.
+ *
+ * @param aTotalSilent Set to ETrue if want silent connection
+ *
+ * @note Not stored persistently. A client needs to set this
+ * again every time it creates the controller.
+ *
+ * @note Leaves with KErrNotFound if connection method was not
+ * set in the repocitory.
+ */
+ void SetDefaultConnectionMethodL( TBool aTotalSilent );
+
+
+ /**
+ * Shows update query dialog (now/later)
+ */
+ void ShowUpdateQueryL();
+
+ /**
+ * Hides this application from fast swap window
+ *
+ * @param aAlwaysAsk
+ */
+ void HideApplicationInFSWL( TBool aHide);
+
+ /**
+ * Shows global error note
+ *
+ * @param aError Symbian error code
+ */
+ void ShowGlobalErrorNoteL( TInt aError ) const;
+
+ /**
+ * CIdle callback function, that shows status dialog
+ * To be used to guarantee that possible old status dialog is totally
+ * removed by AVKON before showing new one
+ *
+ * @param aPtr Pointer to this instance
+ */
+ static TInt ShowStatusDialogCallbackL( TAny* aPtr );
+
+ /**
+ * CIdle callback function, that shows update query dialog
+ * To be used because a client to be informed immediately that its
+ * async request is issued. Waiting dialog cannot be shown before responding to a client
+ *
+ * @param aPtr Pointer to this instance
+ */
+ static TInt UpdateQueryCallbackL( TAny* aPtr );
+
+ /**
+ * CIdle callback function, that performs automatic update check ann query
+ *
+ * @param aPtr Pointer to this instance
+ */
+ static TInt AutomaticCheckCallbackL( TAny* aPtr );
+
+ /**
+ * History view is activated from a link in message query
+ */
+ void HandleTextLinkL();
+
+private: //data
+
+ CIAUpdateMainView* iMainView;
+
+ CIAUpdateHistoryView* iHistoryView;
+
+ CIAUpdateUiController* iController;
+
+ CIAUpdateGlobalLockHandler* iGlobalLockHandler;
+
+ CIAUpdateUITimer* iForegroundTimer;
+
+ CIAUpdateUITimer* iBackgroundTimer;
+
+ MIAUpdateRequestObserver* iRequestObserver;
+
+ TIAUpdateDialogParam* iDialogParam;
+
+ IAUpdateUiDefines::TIAUpdateUiRequestType iRequestType;
+
+ CIdle* iIdle;
+
+ CIdle* iIdleAutCheck;
+
+ TBool iShowStatusDialogAgain;
+
+ TUint iUpdatequeryUid;
+
+ TBool iUpdateNow;
+
+ TBool iInstUiOnTop;
+
+ TBool iStartedFromApplication;
+
+ TBool iClientMovedToBackground;
+
+ RArray<TUint32> iDestIdArray;
+
+ TInt iWgId;
+
+ TBool iIsDMSupported;
+
+ TBool iIsDMSet;
+
+ TBool iUiRefreshAllowed;
+
+ TBool iRebootAfterInstall;
+ };
+
+
+#endif // __IAUPDATE_APPUI_H__
+