locationsystemui/locationsysui/locsuplsettingsui/inc/locsuplsettingsview.h
author hgs
Wed, 03 Nov 2010 23:28:39 +0530
changeset 56 4e949f03ecc5
permissions -rw-r--r--
201044
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
56
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies). 
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:  SUPL Settings UI view
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef C_LOCSUPLSETTINGSVIEW_H_
hgs
parents:
diff changeset
    19
#define C_LOCSUPLSETTINGSVIEW_H_
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
//  System Includes
hgs
parents:
diff changeset
    22
#include <data_caging_path_literals.hrh>
hgs
parents:
diff changeset
    23
#include <e32base.h>
hgs
parents:
diff changeset
    24
#include <aknview.h>
hgs
parents:
diff changeset
    25
#include <ConeResLoader.h>
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
// User Includes
hgs
parents:
diff changeset
    28
#include "locsuplsettingsuid.hrh"
hgs
parents:
diff changeset
    29
#include "locsuplsettingseventhandler.h"
hgs
parents:
diff changeset
    30
hgs
parents:
diff changeset
    31
// Forward Declarations
hgs
parents:
diff changeset
    32
class CLocSUPLSettingsContainer;
hgs
parents:
diff changeset
    33
class MLocSUPLSettingsEventHandler;
hgs
parents:
diff changeset
    34
class CLocSUPLSettingsUiEngine;
hgs
parents:
diff changeset
    35
hgs
parents:
diff changeset
    36
hgs
parents:
diff changeset
    37
// Constant Declarations
hgs
parents:
diff changeset
    38
const TUid KLocSUPLSettingsUiViewId = { KLOCSUPLSETTINGSUIUID3 };
hgs
parents:
diff changeset
    39
_LIT( KLocSUPLSettingsUiResFileName, "locsuplsettingsui.rsc" );
hgs
parents:
diff changeset
    40
hgs
parents:
diff changeset
    41
// Class Declaration
hgs
parents:
diff changeset
    42
hgs
parents:
diff changeset
    43
/**
hgs
parents:
diff changeset
    44
 * SUPL Settings UI View. 
hgs
parents:
diff changeset
    45
 * This class also handles all View specific events for SUPL settings
hgs
parents:
diff changeset
    46
 */
hgs
parents:
diff changeset
    47
class CLocSUPLSettingsView : public CAknView
hgs
parents:
diff changeset
    48
	{
hgs
parents:
diff changeset
    49
    public:
hgs
parents:
diff changeset
    50
        /**
hgs
parents:
diff changeset
    51
         * Creates new SUPL Settings UI View.
hgs
parents:
diff changeset
    52
         *
hgs
parents:
diff changeset
    53
         * @param aEngine                   Reference to the SUPL Settings
hgs
parents:
diff changeset
    54
         *                                  engine
hgs
parents:
diff changeset
    55
         * @param aEventHandler			    Reference to the Event Handler
hgs
parents:
diff changeset
    56
         * @return CLocSUPLSettingsView*	Reference to the application view
hgs
parents:
diff changeset
    57
         */                                                 
hgs
parents:
diff changeset
    58
        static CLocSUPLSettingsView* NewL( 
hgs
parents:
diff changeset
    59
                            CLocSUPLSettingsUiEngine&       aEngine,
hgs
parents:
diff changeset
    60
        					MLocSUPLSettingsEventHandler&	aEventHandler );
hgs
parents:
diff changeset
    61
hgs
parents:
diff changeset
    62
		/**
hgs
parents:
diff changeset
    63
         * Creates new SUPL Settings UI View. Leaves the object on the 
hgs
parents:
diff changeset
    64
         * Clean up stack
hgs
parents:
diff changeset
    65
         *
hgs
parents:
diff changeset
    66
         * @param aEngine                   Reference to the SUPL Settings
hgs
parents:
diff changeset
    67
         *                                  engine          
hgs
parents:
diff changeset
    68
         * @param aEventHandler			    Pointer to the Event Handler
hgs
parents:
diff changeset
    69
		 * @return CLocSUPLSettingsView*	Reference to the application view
hgs
parents:
diff changeset
    70
         */                                                 
hgs
parents:
diff changeset
    71
        static CLocSUPLSettingsView* NewLC( 
hgs
parents:
diff changeset
    72
                            CLocSUPLSettingsUiEngine&       aEngine,
hgs
parents:
diff changeset
    73
         					MLocSUPLSettingsEventHandler&	aEventHandler );
hgs
parents:
diff changeset
    74
        
hgs
parents:
diff changeset
    75
		/**
hgs
parents:
diff changeset
    76
		 * Destructor
hgs
parents:
diff changeset
    77
		 */
hgs
parents:
diff changeset
    78
		~CLocSUPLSettingsView ();
hgs
parents:
diff changeset
    79
		
hgs
parents:
diff changeset
    80
        /**
hgs
parents:
diff changeset
    81
         * Handles the Screen Size update
hgs
parents:
diff changeset
    82
         */
hgs
parents:
diff changeset
    83
        void HandleScreenSizeChange();
hgs
parents:
diff changeset
    84
        
hgs
parents:
diff changeset
    85
        /**
hgs
parents:
diff changeset
    86
         * Updates the View
hgs
parents:
diff changeset
    87
         */
hgs
parents:
diff changeset
    88
        void UpdateView();
hgs
parents:
diff changeset
    89
        
hgs
parents:
diff changeset
    90
        /**
hgs
parents:
diff changeset
    91
         * Indicates that the SUPL settings view is started from the Location
hgs
parents:
diff changeset
    92
         * settings UI server
hgs
parents:
diff changeset
    93
         */
hgs
parents:
diff changeset
    94
        void StartedFromAppServer();
hgs
parents:
diff changeset
    95
            
hgs
parents:
diff changeset
    96
        /**
hgs
parents:
diff changeset
    97
		 * Returns the Selected element. The list box model defines the
hgs
parents:
diff changeset
    98
		 * enumeration that would determine the current element that has been
hgs
parents:
diff changeset
    99
		 * selected
hgs
parents:
diff changeset
   100
		 *
hgs
parents:
diff changeset
   101
		 * @return TInt Index of the item selected
hgs
parents:
diff changeset
   102
		 */
hgs
parents:
diff changeset
   103
		TInt SelectedItemIndex();
hgs
parents:
diff changeset
   104
		         
hgs
parents:
diff changeset
   105
		/**
hgs
parents:
diff changeset
   106
         * From CAknView. 
hgs
parents:
diff changeset
   107
         */
hgs
parents:
diff changeset
   108
		void DoActivateL( const TVwsViewId& aPrevViewId,
hgs
parents:
diff changeset
   109
		 						 TUid		 aCustomMessageId,
hgs
parents:
diff changeset
   110
						   const TDesC8&	 aCustomMessage);
hgs
parents:
diff changeset
   111
		
hgs
parents:
diff changeset
   112
		/**
hgs
parents:
diff changeset
   113
         * From CAknView. 
hgs
parents:
diff changeset
   114
         */
hgs
parents:
diff changeset
   115
        void DoDeactivate();
hgs
parents:
diff changeset
   116
 
hgs
parents:
diff changeset
   117
 		/**
hgs
parents:
diff changeset
   118
         * From CAknView. Returns the View Id. Should be chosen to reflect 
hgs
parents:
diff changeset
   119
		 * the Implementation UID of the Plugin
hgs
parents:
diff changeset
   120
         */
hgs
parents:
diff changeset
   121
        TUid Id() const;
hgs
parents:
diff changeset
   122
hgs
parents:
diff changeset
   123
        /**
hgs
parents:
diff changeset
   124
         * From CAknView. 
hgs
parents:
diff changeset
   125
         */
hgs
parents:
diff changeset
   126
        void HandleCommandL(TInt aCommand);
hgs
parents:
diff changeset
   127
        
hgs
parents:
diff changeset
   128
       /**
hgs
parents:
diff changeset
   129
        * From MEikMenuObserver
hgs
parents:
diff changeset
   130
        */
hgs
parents:
diff changeset
   131
        void DynInitMenuPaneL( TInt aResourceId, CEikMenuPane* aMenuPane );
hgs
parents:
diff changeset
   132
                	
hgs
parents:
diff changeset
   133
        /**
hgs
parents:
diff changeset
   134
         * Resets the Setting View Configuration
hgs
parents:
diff changeset
   135
         */
hgs
parents:
diff changeset
   136
        void Reset();	
hgs
parents:
diff changeset
   137
		
hgs
parents:
diff changeset
   138
		/**
hgs
parents:
diff changeset
   139
		 * Confirmation query to delete
hgs
parents:
diff changeset
   140
		 */
hgs
parents:
diff changeset
   141
		TInt DeletionConfirmationQueryL( );
hgs
parents:
diff changeset
   142
    
hgs
parents:
diff changeset
   143
	private:
hgs
parents:
diff changeset
   144
		/**
hgs
parents:
diff changeset
   145
 		 * C++ Overloaded Constructor
hgs
parents:
diff changeset
   146
		 */
hgs
parents:
diff changeset
   147
		CLocSUPLSettingsView( CLocSUPLSettingsUiEngine&     aEngine,
hgs
parents:
diff changeset
   148
		 					  MLocSUPLSettingsEventHandler&	aEventHandler );
hgs
parents:
diff changeset
   149
hgs
parents:
diff changeset
   150
		/**
hgs
parents:
diff changeset
   151
		 * Second Phase Constructor
hgs
parents:
diff changeset
   152
		 */
hgs
parents:
diff changeset
   153
		void ConstructL();
hgs
parents:
diff changeset
   154
hgs
parents:
diff changeset
   155
       /**
hgs
parents:
diff changeset
   156
        * Shows or dims help option, depending wheather help feature
hgs
parents:
diff changeset
   157
        * is supported or not.
hgs
parents:
diff changeset
   158
        * @param aMenuPane
hgs
parents:
diff changeset
   159
        */
hgs
parents:
diff changeset
   160
        void HandleHelpFeature( CEikMenuPane& aMenuPane ) const;		
hgs
parents:
diff changeset
   161
		
hgs
parents:
diff changeset
   162
       /**
hgs
parents:
diff changeset
   163
        * Changes the command button groups for the view
hgs
parents:
diff changeset
   164
        */
hgs
parents:
diff changeset
   165
		void ChangeMSKL();
hgs
parents:
diff changeset
   166
			
hgs
parents:
diff changeset
   167
	private:		
hgs
parents:
diff changeset
   168
		/**
hgs
parents:
diff changeset
   169
		 * Reference to the event Handler for handling UI events
hgs
parents:
diff changeset
   170
		 */
hgs
parents:
diff changeset
   171
		MLocSUPLSettingsEventHandler&		iEventHandler;
hgs
parents:
diff changeset
   172
	
hgs
parents:
diff changeset
   173
	    /**
hgs
parents:
diff changeset
   174
	     * Reference to the SUPL Settings engine
hgs
parents:
diff changeset
   175
	     */
hgs
parents:
diff changeset
   176
	    CLocSUPLSettingsUiEngine&           iEngine;	
hgs
parents:
diff changeset
   177
		/**
hgs
parents:
diff changeset
   178
		 * Container Object
hgs
parents:
diff changeset
   179
		 * Owns
hgs
parents:
diff changeset
   180
		 */
hgs
parents:
diff changeset
   181
		CLocSUPLSettingsContainer*			iContainer;
hgs
parents:
diff changeset
   182
		
hgs
parents:
diff changeset
   183
		/**
hgs
parents:
diff changeset
   184
		 * Boolean value to indicate that the SUPL settings UI is
hgs
parents:
diff changeset
   185
		 * started from the settings UI server.
hgs
parents:
diff changeset
   186
		 */
hgs
parents:
diff changeset
   187
		TBool                               iStartedFromServer;
hgs
parents:
diff changeset
   188
hgs
parents:
diff changeset
   189
		/**
hgs
parents:
diff changeset
   190
		 * Integer value to indicate whether the SUPL server view
hgs
parents:
diff changeset
   191
                 * or session view was launched
hgs
parents:
diff changeset
   192
		 */
hgs
parents:
diff changeset
   193
		TInt                               iViewLaunched;
hgs
parents:
diff changeset
   194
		
hgs
parents:
diff changeset
   195
	};			
hgs
parents:
diff changeset
   196
hgs
parents:
diff changeset
   197
#endif // C_LOCSUPLSETTINGSVIEW_H_
hgs
parents:
diff changeset
   198