/*

* Copyright (c) 2002-2010 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:   CSisxSifUiSelectionCache saves user selections during

*                installation. Cached selections can be re-used, to avoid

*                displaying the same dialogs again.

*/

#ifndef C_SISXSIFUISELECTIONCACHE_H

#define C_SISXSIFUISELECTIONCACHE_H

#include <e32base.h>

#include <f32file.h>

/**

 * Saves user selections during installation. Installer may re-use

 * cached selections in order to avoid displaying the same prompts

 * several times.

 */

class CSisxSifUiSelectionCache : public CBase

    {

    public:     // constructor and destructor

        static CSisxSifUiSelectionCache* NewL();

        ~CSisxSifUiSelectionCache();

    public:     // new functions

        /**

         * Returns ETrue if language selection is currently cached, and

         * EFalse otherwise. Language selection can be cached by using

         * SetLanguage() method.

         * @return TBool -- ETrue if language is cached

         */

        TBool LanguageCached() const;

        /**

         * Returns the language code saved earlier with SetLanguage() method.

         * If no language has been set, then returns language code 0 (ELangTest).

         * @return TLanguage -- the cached language, or ELangTest

         */

        TLanguage Language() const;

        /**

        * Caches the given language code.

        * @param aLanguage - language to be cached

        */

        void SetLanguage( const TLanguage& aLanguage );

        /**

        * Returns ETrue if drive selection is currently cacehed, and EFalse

        * otherwise. Drive selection can be cached by using SetDrive() method.

        * @return TBool -- ETrue if drive is cached

        */

        TBool DriveCached() const;

        /**

        * Returns the drive saved earlier with SetDrive() method.

        * @return TDriveUnit -- the cached drive

        */

        TDriveUnit Drive() const;

        /**

        * Caches the given drive.

        * @param aLanguage -- drive to be cached

        */

        void SetDrive( TDriveUnit aDrive );

        /**

        * Returns ETrue if all options in aOptions array are cached, and EFalse

        * otherwise. Options can be cached using SetOptions() method.

        * @param aOptions -- array of options names

        * @return TBool -- ETrue if all aOptions are cached

        */

        TBool OptionsCached( const RPointerArray<TDesC>& aOptions ) const;

        /**

        * Returns the options saved earlier with SetOptions() method.

        * @param aSelections -- the cached option selections

        */

        void Options( RArray<TBool>& aSelections );

        /**

        * Caches the given options.

        * @param aOptions -- array of options names

        * @param aSelections -- array of option selections

        */

        void SetOptionsL( const RPointerArray<TDesC>& aOptions, const RArray<TBool>& aSelections );    

    private:    // new functions

        CSisxSifUiSelectionCache();

        void ConstructL();

    private:    // data

        TBool iLanguageCached;

        TLanguage iLanguage;

        TDriveUnit iDrive;        

        RPointerArray<HBufC> iOptions;        

        RArray<TBool> iSelections;       

    };

#endif      // C_SISXSIFUISELECTIONCACHE_H