--- 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