/*
* Copyright (c) 2007-2007 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:  For CSC application startup parameter handling
*
*/


#ifndef C_CSCENGSTARTUPHANDLER_H
#define C_CSCENGSTARTUPHANDLER_H


/**
 *  An instance of CSCEngStartupHandler
 *  For CSC application startup parameter handling
 *
 *  @lib CSCEngine.lib
 *  @since S60 v3.2
 */
NONSHARABLE_CLASS ( CCSCEngStartupHandler ) : public CBase
    {
    public:

        /**  Enumeration for different startup actions */
        enum TAction
            {
            EDefaultAction = 0,
            EAddSetupPluginService, // for service setup plugins
            ERemoveSetupPluginService,  
            EOpenUiExtension, // for ui extensions plugins
            EOpenSettingsUi
            };
        
        
        /**  Enumeration for different uid types */
        enum TUidType
            {
            EPluginUid = 0,
            EAppUid    
            };


        /**
         * Two-phased constructor.
         */
        IMPORT_C static CCSCEngStartupHandler* NewL();

 
        /**
         * Destructor.
         */
        virtual ~CCSCEngStartupHandler();
        
                
        /**
         * Sets CSC startup parameters.
         *
         * @since S60 v3.2
         * @param aParameters string containing startup parameters
         * @return KErrNone if successful
         */
        IMPORT_C TInt SetStartupParametersL( const TDesC& aParameters );
        
        
        /**
         * Gets startup parameter Action
         *
         * @since S60 v3.2
         * @return action enum
         */
        IMPORT_C TAction GetParamAction() const;
        
        /**
         * Gets startup parameter service id
         *
         * @since S60 v3.2
         * @return service id
         */
        IMPORT_C TUint GetParamServiceId() const;
        
        
        /**
         * Gets startup parameter UI Extension Plug-in UID
         *
         * @since S60 v3.2
         * @return plugin uid
         */
        IMPORT_C const TUid GetParamPluginUid() const;
        
        
        /**
         * Gets startup parameter application UID
         *
         * @since S60 v3.2
         * @return application uid
         */
        IMPORT_C const TUid GetParamAppUid() const;
        
        
        /**
         * Gets startup parameter URL. 
         *
         * @since S60 v3.2
         * @param aUrl url is stored here
         * @return error code
         */
        IMPORT_C TInt GetParamUrl( TDes& aUrl ) const;
        
        
        /**
         * Resets uid value by uid type
         *
         * @since S60 v3.2
         * @param aType plugin type
         */
        IMPORT_C void ResetUid( TUidType aType );
        
        
        /**
         * Resets service id
         *
         * @since S60 v3.2
         */
        IMPORT_C void ResetServiceId();
        
        /**
         * For settings flag if csc was started from homescreen.
         *
         * @since S60 v5.0
         */
        IMPORT_C void SetStartedFromHomescreen( TBool aStartedFromHomescreen );
                
        /**
         * For getting flag if csc was started from homescreen.
         *
         * @since S60 v5.0
         */
        IMPORT_C TBool StartedFromHomescreen() const;
        
                        
    private:

        CCSCEngStartupHandler();


        void ConstructL();
        
        
        /**
         * Parses and sets startup parameter action
         *
         * @since S60 v3.2
         * @param aParameters string containing startup parameters
         */
        void SetAction( const TDesC& aParameters );
        
        
        /**
         * Parses and sets startup parameter service id
         *
         * @since S60 v3.2
         * @param aParameters string containing startup parameters
         */
        void SetServiceId( const TDesC& aParameters );
        
        
        /**
         * Parses and sets startup parameter plugin uid
         *
         * @since S60 v3.2
         * @param aParameters string containing startup parameters
         * @param aUidType uid type
         */
        void SetUid( const TDesC& aParameters, TUidType aUidType );
        
                
        /**
         * Parses and sets startup parameter URL
         *
         * @since S60 v3.2
         * @param aParameters string containing startup parameters
         */
        void SetUrlL( const TDesC& aParameters );
        
        
    private: // data
    
        /**
         * Action type parameter
         */
        TAction iAction;
        
        /**
         * Service id parameter
         */
   		TUint iServiceId;
    
        /**
         * Plugin uid parameter
         */
   		TUid iPluginUid;
   		
   		/**
         * Application uid parameter
         */
   		TUid iAppUid;
   		
   		/**
         * URL parameter
         * Own.
         */
   		HBufC* iURL;       
   		
        /**
         * To deternmine if csc was started from homescreen.
         * Own.
         */
        TBool iStartedFromHomescreen;
    };

#endif  // C_CSCENGSTARTUPHANDLER_H