radioengine/settings/tsrc/inc/SettingsTestModule.h
changeset 51 bbebb0235466
parent 34 bc10a61bd7d3
--- a/radioengine/settings/tsrc/inc/SettingsTestModule.h	Fri Sep 03 12:25:04 2010 +0300
+++ b/radioengine/settings/tsrc/inc/SettingsTestModule.h	Mon Sep 20 18:04:48 2010 +0300
@@ -1,286 +1,224 @@
 /*
-* 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: STIF testclass declaration
-*
-*/
+ * 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: STIF testclass declaration
+ *
+ */
 
 #ifndef SettingsTestMODULE_H
 #define SettingsTestMODULE_H
 
-//  INCLUDES
+// System includes
 #include <StifLogger.h>
 #include <TestScripterInternal.h>
 #include <StifTestModule.h>
 #include <TestclassAssert.h>
-//INTERNAL INCLUDES
+// User includes
 #include "cradiosettings.h"
 #include "mradiosettingsobserver.h"
 #include "trace.h"
 
-
 // CONSTANTS
-const TInt KErrBadTestParameter= -1000;         // Error on configuration file
-
-const TInt KErrEventPending =-2000;             // Timeout and not callback 
-const TInt KErrCallbackErrorCode = -2001;       // Callback return error code
-const TInt KErrUnexpectedValue =-2002;          // Unexpected value at setting    
-const TInt KExpectedFrequencyChange = -2003;        // Is not finding more than one station
-const TInt KErrTimeoutController = -2007;       // Unexpected notification
+const TInt KErrBadTestParameter = -1000; // Error on configuration file
+const TInt KErrEventPending = -2000; // Timeout and not callback 
+const TInt KErrCallbackErrorCode = -2001; // Callback return error code
+const TInt KErrUnexpectedValue = -2002; // Unexpected value at setting    
+const TInt KExpectedFrequencyChange = -2003; // Is not finding more than one station
+const TInt KErrTimeoutController = -2007; // Unexpected notification
 
 // MACROS
-//#define ?macro ?macro_def
 #define TEST_CLASS_VERSION_MAJOR 1
 #define TEST_CLASS_VERSION_MINOR 1
 #define TEST_CLASS_VERSION_BUILD 1
-
 // Logging path
-_LIT( KSettingsTestModuleLogPath, "\\logs\\testframework\\SettingsTestModule\\" ); 
+_LIT( KSettingsTestModuleLogPath, "\\logs\\testframework\\SettingsTestModule\\" );
 // Log file
-_LIT( KSettingsTestModuleLogFile, "SettingsTestModule.txt" ); 
+_LIT( KSettingsTestModuleLogFile, "SettingsTestModule.txt" );
 _LIT( KSettingsTestModuleLogFileWithTitle, "SettingsTestModule_[%S].txt" );
 
-// FUNCTION PROTOTYPES
-//?type ?function_name(?arg_list);
-
-// FORWARD DECLARATIONS
-//class ?FORWARD_CLASSNAME;
-//class CSettingsTestModule;
-
-// DATA TYPES
-//enum ?declaration
-//typedef ?declaration
-//extern ?data_type;
-
 // CLASS DECLARATION
 
 /**
-*  CSettingsTestModule test class for STIF Test Framework TestScripter.
-*  ?other_description_lines
-*
-*  @lib ?library
-*  @since ?Series60_version
-*/
-NONSHARABLE_CLASS(CSettingsTestModule) : public CScriptBase, public MRadioSettingsObserver
+ *  CSettingsTestModule test class for STIF Test Framework TestScripter.
+ *  ?other_description_lines
+ *
+ *  @lib SettingsTestModule.dll
+ *  @since S60 10.1
+ */
+NONSHARABLE_CLASS(CSettingsTestModule) : public CScriptBase,
+        public MRadioSettingsObserver
     {
-    public:  // Constructors and destructor
+public:
+    // Constructors and destructor
 
-        /**
-        * Two-phased constructor.
-        */
-        static CSettingsTestModule* NewL( CTestModuleIf& aTestModuleIf );
+    /**
+     * Two-phased constructor.
+     */
+    static CSettingsTestModule* NewL(CTestModuleIf& aTestModuleIf);
 
-        /**
-        * Destructor.
-        */
-        virtual ~CSettingsTestModule();
+    /**
+     * Destructor.
+     */
+    virtual ~CSettingsTestModule();
 
-    public: // New functions
+public:
+    // Functions from base classes
 
-        /**
-        * ?member_description.
-        * @since ?Series60_version
-        * @param ?arg1 ?description
-        * @return ?description
-        */
-        //?type ?member_function( ?type ?arg1 );
+    /**
+     * From CScriptBase Runs a script line.
+     * @since ?Series60_version
+     * @param aItem Script line containing method name and parameters
+     * @return Symbian OS error code
+     */
+    virtual TInt RunMethodL(CStifItemParser& aItem);
+
+    // MRadioSettingsObserver
 
-    public: // Functions from base classes
+    /**
+     * From MRadioSettingsObserver.
+     * Notifies of the change in RDS alternate frequency setting
+     *
+     * @param aEnabled ETrue if AF search is enabled, otherwise EFalse
+     */
+    virtual void RdsAfSearchSettingChangedL(TBool aEnabled);
 
-        /**
-        * From CScriptBase Runs a script line.
-        * @since ?Series60_version
-        * @param aItem Script line containing method name and parameters
-        * @return Symbian OS error code
-        */
-        virtual TInt RunMethodL( CStifItemParser& aItem );
+    /**
+     * From MRadioSettingsObserver.
+     * Notifies of the change in region setting when it is changed
+     * outside of the particular radio settings instance
+     *
+     * @param aRegion The new region ID
+     */
+    virtual void RegionSettingChangedL(TInt aRegion);
 
-        // MRadioSettingsObserver
-        
-        /**
-        * From MRadioSettingsObserver.
-         * Notifies of the change in RDS alternate frequency setting
-         *
-         * @param aEnabled ETrue if AF search is enabled, otherwise EFalse
-         */
-        virtual void RdsAfSearchSettingChangedL( TBool aEnabled );
+protected:
+    // New functions
+
+    // Test case functions
+    TInt CreateSettingsL(CStifItemParser& aItem);
+    TInt DestroySettingsL(CStifItemParser& aItem);
+
+    TInt IsRegionAllowed(CStifItemParser& aItem);
+
+    TInt ResolveDriveL(CStifItemParser& aItem);
 
-        /**
-        * From MRadioSettingsObserver.
-         * Notifies of the change in region setting when it is changed
-         * outside of the particular radio settings instance
-         *
-         * @param aRegion The new region ID
-         */
-        virtual void RegionSettingChangedL( TInt aRegion );
-        
-    protected:  // New functions
+    // Application Settings functions
+
+    TInt SetFirstTimeStartPerformed(CStifItemParser& aItem);
+    TInt IsFirstTimeStart(CStifItemParser& aItem);
+
+    TInt SetUiFlags(CStifItemParser& aItem);
+
+    TInt UiFlags(CStifItemParser& aItem);
+
+    // Settings functions
 
-        /**
-        * ?member_description.
-        * @since ?Series60_version
-        * @param ?arg1 ?description
-        * @return ?description
-        */
-        //?type ?member_function( ?type ?arg1 );
-        // Test case functions
-        TInt CreateSettingsL( CStifItemParser& aItem );
-        TInt DestroySettingsL( CStifItemParser& aItem );
-        
-        TInt IsRegionAllowed( CStifItemParser& aItem );
-        
-        TInt ResolveDriveL( CStifItemParser& aItem );
-        
-        // Application Settings functions
-        
-        TInt SetFirstTimeStartPerformed( CStifItemParser& aItem );
-        TInt IsFirstTimeStart( CStifItemParser& aItem );
-        
-        TInt SetUiFlags( CStifItemParser& aItem );
-        
-        TInt UiFlags( CStifItemParser& aItem );
-               
-        // Settings functions
-        
-        TInt HeadsetVolume ( CStifItemParser& aItem );
-        TInt SpeakerVolume ( CStifItemParser& aItem );
-        TInt Volume ( CStifItemParser& aItem );
-        TInt OutputMode ( CStifItemParser& aItem );
-        TInt AudioRoute ( CStifItemParser& aItem );
-        TInt IsHeadsetVolMuted ( CStifItemParser& aItem );
-        TInt IsSpeakerVolMuted ( CStifItemParser& aItem );
-        TInt IsVolMuted ( CStifItemParser& aItem );
-        TInt IsPowerOn ( CStifItemParser& aItem );
-        TInt TunedFrequency ( CStifItemParser& aItem );
-        TInt DefaultMinVolumeLevel ( CStifItemParser& aItem );
-        TInt CountRegions ( CStifItemParser& aItem );
-        TInt Region ( CStifItemParser& aItem );
-        TInt RegionId ( CStifItemParser& aItem );
-        TInt FrequencyStepSize ( CStifItemParser& aItem );
-        TInt MaxFrequency ( CStifItemParser& aItem );
-        TInt MinFrequency ( CStifItemParser& aItem );
-        TInt DecimalCount ( CStifItemParser& aItem );
-        TInt DefaultRegion ( CStifItemParser& aItem );
-        TInt NetworkId ( CStifItemParser& aItem );
-        TInt CountryCode ( CStifItemParser& aItem );
-        TInt OperatorMusicStoreURL ( CStifItemParser& aItem );
-        TInt OperatorMusicStoreName ( CStifItemParser& aItem );
+    TInt HeadsetVolume(CStifItemParser& aItem);
+    TInt SpeakerVolume(CStifItemParser& aItem);
+    TInt Volume(CStifItemParser& aItem);
+    TInt OutputMode(CStifItemParser& aItem);
+    TInt AudioRoute(CStifItemParser& aItem);
+    TInt IsHeadsetVolMuted(CStifItemParser& aItem);
+    TInt IsSpeakerVolMuted(CStifItemParser& aItem);
+    TInt IsVolMuted(CStifItemParser& aItem);
+    TInt IsPowerOn(CStifItemParser& aItem);
+    TInt TunedFrequency(CStifItemParser& aItem);
+    TInt DefaultMinVolumeLevel(CStifItemParser& aItem);
+    TInt CountRegions(CStifItemParser& aItem);
+    TInt Region(CStifItemParser& aItem);
+    TInt RegionId(CStifItemParser& aItem);
+    TInt FrequencyStepSize(CStifItemParser& aItem);
+    TInt MaxFrequency(CStifItemParser& aItem);
+    TInt MinFrequency(CStifItemParser& aItem);
+    TInt DecimalCount(CStifItemParser& aItem);
+    TInt DefaultRegion(CStifItemParser& aItem);
+    TInt NetworkId(CStifItemParser& aItem);
+    TInt CountryCode(CStifItemParser& aItem);
+    TInt OperatorMusicStoreURL(CStifItemParser& aItem);
+    TInt OperatorMusicStoreName(CStifItemParser& aItem);
 
-        // Setter functions
-        
-        TInt SetHeadsetVolume ( CStifItemParser& aItem );
-        TInt SetSpeakerVolume ( CStifItemParser& aItem );
-        TInt SetVolume ( CStifItemParser& aItem );
-        TInt SetOutputMode ( CStifItemParser& aItem );
-        TInt SetAudioRoute ( CStifItemParser& aItem );
-        TInt SetHeadsetVolMuted ( CStifItemParser& aItem );
-        TInt SetSpeakerVolMuted ( CStifItemParser& aItem );
-        TInt SetVolMuted ( CStifItemParser& aItem );
-        TInt SetPowerOn ( CStifItemParser& aItem );
-        TInt SetTunedFrequency ( CStifItemParser& aItem );
-        TInt SetRegionId ( CStifItemParser& aItem );
-        TInt SetNetworkId ( CStifItemParser& aItem );
-        TInt SetCountryCode ( CStifItemParser& aItem );
-        TInt SetOperatorMusicStoreURL ( CStifItemParser& aItem );
-        TInt SetOperatorMusicStoreName ( CStifItemParser& aItem );
-        
-        // Tst functions
-        TInt ReadConfigurableKeysL ( CStifItemParser& aItem );
-        TInt tstSetRegionIdL ( CStifItemParser& aItem );
-        TInt tstIsRegionSettingChangeNotified ( CStifItemParser& aItem );
-        TInt tstResetStartCount ( CStifItemParser& aItem );
-        
-    protected:  // Functions from base classes
+    // Setter functions
+
+    TInt SetHeadsetVolume(CStifItemParser& aItem);
+    TInt SetSpeakerVolume(CStifItemParser& aItem);
+    TInt SetVolume(CStifItemParser& aItem);
+    TInt SetOutputMode(CStifItemParser& aItem);
+    TInt SetAudioRoute(CStifItemParser& aItem);
+    TInt SetHeadsetVolMuted(CStifItemParser& aItem);
+    TInt SetSpeakerVolMuted(CStifItemParser& aItem);
+    TInt SetVolMuted(CStifItemParser& aItem);
+    TInt SetPowerOn(CStifItemParser& aItem);
+    TInt SetTunedFrequency(CStifItemParser& aItem);
+    TInt SetRegionId(CStifItemParser& aItem);
+    TInt SetNetworkId(CStifItemParser& aItem);
+    TInt SetCountryCode(CStifItemParser& aItem);
+    TInt SetOperatorMusicStoreURL(CStifItemParser& aItem);
+    TInt SetOperatorMusicStoreName(CStifItemParser& aItem);
+
+    // Tst functions
+    TInt ReadConfigurableKeysL(CStifItemParser& aItem);
+    TInt tstSetRegionIdL(CStifItemParser& aItem);
+    TInt tstIsRegionSettingChangeNotified(CStifItemParser& aItem);
+    TInt tstResetStartCount(CStifItemParser& aItem);
 
-        /**
-        * From ?base_class ?member_description
-        */
-        //?type ?member_function();
+private:
 
-    private:
-
-        /**
-        * C++ default constructor.
-        */
-        CSettingsTestModule( CTestModuleIf& aTestModuleIf );
+    /**
+     * C++ default constructor.
+     */
+    CSettingsTestModule(CTestModuleIf& aTestModuleIf);
 
-        /**
-        * By default Symbian 2nd phase constructor is private.
-        */
-        void ConstructL();
-
-        // Prohibit copy constructor if not deriving from CBase.
-        // ?classname( const ?classname& );
-        // Prohibit assigment operator if not deriving from CBase.
-        // ?classname& operator=( const ?classname& );
+    /**
+     * By default Symbian 2nd phase constructor is private.
+     */
+    void ConstructL();
 
-        /**
-        * Frees all resources allocated from test methods.
-        * @since ?Series60_version
-        */
-        void Delete();
+    // Prohibit copy constructor if not deriving from CBase.
+    // ?classname( const ?classname& );
+    // Prohibit assigment operator if not deriving from CBase.
+    // ?classname& operator=( const ?classname& );
 
-        /**
-        * Test methods are listed below. 
-        */
+    /**
+     * Frees all resources allocated from test methods.
+     * @since ?Series60_version
+     */
+    void Delete();
 
-        /**
-        * Example test method.
-        * @since ?Series60_version
-        * @param aItem Script line containing parameters.
-        * @return Symbian OS error code.
-        */
-        virtual TInt ExampleL( CStifItemParser& aItem );
-        
-        /**
-         * Method used to log version of test class
-         */
-        void SendTestClassVersion();
+    /**
+     * Test methods are listed below. 
+     */
 
-        //ADD NEW METHOD DEC HERE
-        //[TestMethods] - Do not remove
-
-    public:     // Data
-        // ?one_line_short_description_of_data
-        //?data_declaration;
+    /**
+     * Example test method.
+     * @since ?Series60_version
+     * @param aItem Script line containing parameters.
+     * @return Symbian OS error code.
+     */
+    virtual TInt ExampleL(CStifItemParser& aItem);
 
-    protected:  // Data
-        // ?one_line_short_description_of_data
-        //?data_declaration;
-
-    private:    // Data
-        
-        // ?one_line_short_description_of_data
-        //?data_declaration;
-
-        // Reserved pointer for future extension
-        //TAny* iReserved;
+    /**
+     * Method used to log version of test class
+     */
+    void SendTestClassVersion();
 
-        /** Radio Settings */
-        CRadioSettings* iSettings;
-        
-        TBool iRegionSettingChangeNotified;
+private:
+    // Data
 
-        
-    public:     // Friend classes
-        //?friend_class_declaration;
-    protected:  // Friend classes
-        //?friend_class_declaration;
-    private:    // Friend classes
-        //?friend_class_declaration;
+    /** Radio Settings */
+    CRadioSettings* iSettings;
 
+    TBool iRegionSettingChangeNotified;
     };
 
 #endif      // SettingsTestMODULE_H
-
 // End of File