diff -r 65a3ef1d5bd0 -r f742655b05bf voipplugins/voipadapters/cpgenvoipsettings/inc/cwpgeneralvoipsettingsadapter.h --- a/voipplugins/voipadapters/cpgenvoipsettings/inc/cwpgeneralvoipsettingsadapter.h Thu Aug 19 09:45:22 2010 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,504 +0,0 @@ -/* -* Copyright (c) 2006 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: ?Description -* -*/ - - -#ifndef CWPGENERALVOIPSETTINGSADAPTER_H -#define CWPGENERALVOIPSETTINGSADAPTER_H - -#include -#include - -class CWPCharacteristic; - -/** - * Realizes general VoIP settings provisioning adapter. - * - * General VoIP settings adapter handles general VoIP settings and stores - * them via Central Repository. - * - * @lib CWPGeneralVoIPSettingsAdapter.lib - * @since S60 v3.0. - */ -class CWPGeneralVoIPSettingsAdapter : public CWPAdapter, public MWPContextExtension - { - #ifdef _DEBUG - /** - * Friend class for unit testing. - */ - friend class UT_CWPGeneralVoIPSettingsAdapter; - #endif - - public: - - static CWPGeneralVoIPSettingsAdapter* NewL(); - - virtual ~CWPGeneralVoIPSettingsAdapter(); - - /** - * Setter for iName. - * - * @since S60 v3.0. - * @param aName User viewable name of general VoIP settings. - */ - void SetNameL( const TDesC& aName ); - - /** - * Setter for iToAppref. Value is changed only if iToApprefSet - * is EFalse. - * - * @since S60 v3.2.3. - * @param aToAppRef Value for TO-APPREF. Links to VoIP settings. - */ - void SetToApprefL( const TDesC8& aToAppRef ); - - /** - * Setter for iClir. - * - * @since S60 v3.0. - * @param aClir Value for VoIP CLIR enabling rule. - */ - void SetClir( const TInt aClir ); - - /** - * Setter for iACBRule. - * - * @since S60 v3.0. - * @param aACBRule Value for anonymous call blocking rule. - */ - void SetACBRule( const TInt aACBRule ); - - /** - * Setter for iPrefTel. - * - * @since S60 v3.0. - * @param aPrefTel Preferred telephony mode value. - */ - void SetPrefTel( const TInt aPrefTel ); - - /** - * Setter for iDnd. - * - * @since S60 v3.0. - * @param aDnd Value for do not disturb setting. - */ - void SetDnd( const TInt aDnd ); - - /** - * Setter for iPSCallWaiting. - * - * @since S60 v3.0. - * @param aPSCallWaiting Value for PS call waiting rule. - */ - void SetPSCallWaiting( const TInt aPSCallWaiting ); - - /** - * Setter for iPrefTelLock. - * - * @since S60 v3.0. - * @param aPrefTelLock Value for telephony preference lock. - */ - void SetPrefTelLock( const TInt aPrefTelLock ); - - /** - * Setter for iCsRadioWifiOff. - * - * @since S60 v3.0. - * @param aCsRadioWifiOff Value for turning CS radio off in WiFi mode. - */ - void SetCsRadioWifiOff( const TInt aCsRadioWifiOff ); - - /** - * Getter for iProviderId. - * - * @since S60 v3.0. - * @return Provider of general VoIP settings. - */ - TDesC& ProviderId(); - - /** - * Getter for iName. - * - * @since S60 v3.0. - * @return User viewable name of general VoIP settings. - */ - TDesC& Name(); - - /** - * Getter for iClir. - * - * @since S60 v3.0. - * @return Value for VoIP CLIR enabling rule. - */ - TInt Clir(); - - /** - * Getter for iACBRule. - * - * @since S60 v3.0. - * @return Value for anonymous call blocking rule. - */ - TInt ACBRule(); - - /** - * Getter for iPrefTel. - * - * @since S60 v3.0. - * @return Preferred telephony mode value. - */ - TInt PrefTel(); - - /** - * Getter for iDnd. - * - * @since S60 v3.0. - * @return Value for do not disturb setting. - */ - TInt Dnd(); - - /** - * Getter for iPSCallWaiting. - * - * @since S60 v3.0. - * @return Value for call waiting rule. - */ - TInt PSCallWaiting(); - - /** - * Getter for iPrefTelLock. - * - * @since S60 v3.0. - * @return Value for telephony preference lock. - */ - TInt PrefTelLock(); - - /** - * Getter for iCsRadioWifiOff. - * - * @since S60 v3.0. - * @return Value for turning CS radio off in WiFi mode. - */ - TInt CsRadioWifiOff(); - - // from base class CWPAdapter - - /** - * From CWPAdapter. - * Checks the number of settings items. - * - * @since S60 v3.0. - * @return Quantity of items (always one). - */ - TInt ItemCount() const; - - /** - * From CWPAdapter. - * Getter for the summary title of general VoIP settings item. Text is - * shown to the user in an opened configuration message. - * - * @since S60 v3.0. - * @param aIndex Not used. - * @return Summary title. - */ - const TDesC16& SummaryTitle( TInt /*aIndex*/ ) const; - - /** - * From CWPAdapter. - * Getter for the summary text of general VoIP settings. Text is shown - * to the user in opened configuration message. - * - * @since S60 v3.0. - * @param aIndex Not used. - * @return Summary text. - */ - const TDesC16& SummaryText( TInt /*aIndex*/ ) const; - - /** - * From CWPAdapter. - * Saves general VoIP settings. - * - * @since S60 v3.0. - * @param aIndex Not used. - */ - void SaveL( TInt /*aIndex*/ ); - - /** - * From CWPAdapter. - * Returns EFalse since there can only be one set of general VoIP - * settings. - * - * @since S60 v3.0. - * @param aIndex Location of the general VoIP settings item to - * be queried. Not used. - * @return Information whether these settings can be set as default. - */ - TBool CanSetAsDefault( TInt /*aIndex*/ ) const; - - /** - * From CWPAdapter. - * Adapter sets the settings as default. Not supported. - * - * @since S60 v3.0. - * @param aIndex Location of the general VoIP settings item to be - * set as default. - */ - void SetAsDefaultL( TInt /*aIndex*/ ) - { - }; - - /** - * From CWPAdapter. - * Query for detailed information about the general VoIP settings. - * This is not supported feature as in other adapters in the framework. - * - * @since S60 v3.0. - * @param aItem Not used but here because of inheritance. - * @param aVisitor Object for retrieveing details of a setting entry. - * @return KErrNotSupported if not supported. - */ - TInt DetailsL( TInt aItem, MWPPairVisitor& aVisitor ); - - /** - * From CWPAdapter. - * Visit method. Visits the adapter. Adapter checks from - * aCharacteristic if the data is targetet to it and acts according to - * that. - * - * @since S60 v3.0. - * @param aCharacteristic The characteristic found. - */ - void VisitL( CWPCharacteristic& aCharacteristic ); - - /** - * From CWPAdapter. - * Visit method. Visits the adapter. Method sets the iAppId value. - * - * @since S60 v3.0. - * @param aParameter The parameter found. - */ - void VisitL( CWPParameter& aParameter ); - - /** - * From CWPAdapter. - * Visit method. Not supported. - * - * @since S60 v3.0. - * @param aLink Link to the characteristic. - */ - void VisitLinkL( CWPCharacteristic& /*aLink*/ ) - { - }; - - /** - * From CWPAdapter. - * Informs the adapters of the saved settings. Not supported since - * this adapter does not communicate with other adapters. - * - * @since S60 v3.0. - * @param aAppIdOfSavingItem UID of the adapter component. - * @param aAppRef APPREF of the saved settings. - * @param aStorageIdValue Value that identifies the settings in its - * storage. - */ - void SettingsSavedL ( const TDesC8& aAppIdOfSavingItem, - const TDesC8& aAppRef, const TDesC8& aStorageIdValue ); - - /** - * From CWPAdapter. - * Lets the adapters know when the saving has been finalized in - * viewpoint of the provisioning framework. The adapters can make - * finalization of saving the settings after receiving this call. - * - * @since S60 v3.0. - */ - void SavingFinalizedL(); - - // from base class MWPContextExtension - - /** - * From MWPContextExtension. - * Returns a pointer to a context extension. - * - * @since S60 v3.0. - * @param aExtension Contains a pointer to MWPContextExtension if - * supported. - * @return KErrNotSupported if not supported, otherwise KErrNone. - */ - TInt ContextExtension( MWPContextExtension*& aExtension ); - - /** - * From MWPContextExtension. - * Returns the data used for saving. - * - * @since S60 v3.0. - * @param aIndex The index of the data. - * @return The data; ownership is transferred. - */ - const TDesC8& SaveDataL( TInt /*aIndex*/ ) const; - - /** - * From MWPContextExtension. - * Deletes a saved settings. - * - * @since S60 v3.0. - * @param aSaveData The data used for saving. - */ - void DeleteL( const TDesC8& aSaveData ); - - /** - * From MWPContextExtension. - * Returns the UID of the adapter. - * - * @since S60 v3.0. - * @return UID of the adapter. - */ - TUint32 Uid() const; - - protected: - - private: - - CWPGeneralVoIPSettingsAdapter(); - - void ConstructL(); - - public: // Data - - private: // Data - - /** - * Application ID of the current characteristic. - */ - TPtrC iAppID; - - /** - * Confirms whether APPID is correct (w9033). - */ - TBool iIsAppIdOk; - - /** - * Confirms whether iName has been correctly set. - */ - TBool iIsNameOk; - - /** - * Title for general VoIP settings. Value read from the resource file - * in initiation phase. - * Own. - */ - HBufC16* iTitle; - - /** - * Holds the ID of saved data. - * Here because of inherited method SaveDataL. - * Own. - */ - HBufC8* iSavedDataId; - - /** - * Default name of general VoIP settings visible to user when viewing - * the provisioning message. Value is read from the resource file in - * initiation phase. - * Own. - */ - HBufC* iDefaultName; - - /** - * Name of general VoIP settings visible to user when viewing the - * provisioning message. - * Own. - */ - HBufC* iName; - - /** - * The VoIP APPREF references by TO-APPREF of general VoIP settings. - * Own. - */ - HBufC8* iToAppref; - - /** - * A flag indicating whether or not correct TO-APPREF value - * has been found. - */ - TBool iToApprefSet; - - /** - * VoIP CLIR. Tells whether CLIR (Calling Line Identification - * Restriction) is enabled or disabled. See w9033.txt or - * VoIP software settings document. - * CP parameter: CLIR. - */ - TInt iClir; - - /** - * Anonymous Call Block rule. Determines the rule for Anonymous Call - * Block feature. See w9033.txt or VoIP software settings document. - * CP parameter: ACBRULE. - */ - TInt iACBRule; - - /** - * Preferred telephony. Tells which telephony mode is preferred. - * See w9033.txt or VoIP software settings document. - * CP parameter: PREFTEL. - */ - TInt iPrefTel; - - /** - * Do Not Disturb (DND) setting. See w9033.txt or VoIP software - * settings document. - * CP parameter: DND. - */ - TInt iDnd; - - /** - * Call waiting. Tells whether call waiting is enabled or disabled. - * See w9033.txt or VoIP software settings document. - * CP parameter: PSCALLWAITING. - */ - TInt iPSCallWaiting; - - - /** - * Telephony preference lock. Tells whether preferred telephony mode - * is UI editable. See w9033.txt or VoIP software settings document. - * CP parameter: PREFTELLOCK. - */ - TInt iPrefTelLock; - - - /** - * Shut down CS radio in WiFi mode. Tells whether CS radio is turned - * off in WiFi mode. See w9033.txt or VoIP software settings document. - * CP parameter: CSRADIOWIFIOFF. - */ - TInt iCsRadioWifiOff; - - /** - * Flag telling if feature manager has been initialized. - */ - TBool iFeatMgrInitialized; - - /** - * VoIP ID received from cpvoipadapter in SettingsSavedL method. - */ - TUint32 iVoipId; - - }; - -#endif // CWPGENERALVOIPSETTINGSADAPTER_H - -// End of File