/*

* 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: This file contains the header file of the CUIStore.

*

*/

#ifndef UISTOREIF_H

#define UISTOREIF_H

// INCLUDES

#include <e32std.h>

#include <e32keys.h>

#include <StifTestInterface.h>

#include <stifinternal/RRefArray.h>

// EXTERNAL DATA STRUCTURES

// EXTERNAL FUNCTION PROTOTYPES  

// CONSTANTS

// MACROS

// LOCAL CONSTANTS AND MACROS

// MODULE DATA STRUCTURES

// LOCAL FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CUIStore;

class CStartedTestCase;

class CTestInfo;

// CONSTANTS

// CLASS DECLARATION

/**

* UI Store class interface. UI must derive this to use UI Store.

*/

class CUIStoreIf 

    :public CBase

    {

    public: // Enumerations

        // Updated flags

        enum TUpdateFlags

            {

            // Test case status updates 

            EStatusRunning  = 0x00000001,

            EStatusExecuted = 0x00000002,

            EStatusPassed   = 0x00000004,

            EStatusFailed   = 0x00000008,

            EStatusAborted  = 0x00000010,

            EStatusCrashed  = 0x00000020,

            EStatusAll      = 0x000000ff,

            // Test set updates

            ESetRunning     = 0x00000100,

            ESetExecuted    = 0x00000200,

            ESetPassed      = 0x00000400,

            ESetFailed      = 0x00000800,

            ESetAll         = 0x0000ff00,

            // Other updates

            EPrintUpdate    = 0x00010000,                              

            };

    private: // Enumerations

        // None

    public: // Constructors and destructor

        /**

        * Destructor.

        */      

        IMPORT_C ~CUIStoreIf();

    protected:

        /**

        * Constructor

        */

        IMPORT_C CUIStoreIf();

        /**

        * Symbian OS second phase constructor. This must be called 

        * from derived class ConstructL.

        */      

        IMPORT_C void ConstructL();

    public: // New functions

        /**

        * Returns reference to CUIStore object, 

        * which handles test cases and test modules.

        */

        IMPORT_C CUIStore& UIStore();

        /**

        * Receives output update notification from CUIStore.

        * UI implements this to get update notifications. 

        * aFlags are from 

        */

        virtual void Update( CStartedTestCase* /*aTestCase*/, 

                             TInt /* aFlags */ ){};

        /**

        * Function is called when test framework prints error.

        */

        virtual void Error( TErrorNotification& /*aError*/ ){};

        /**

        * Function is called to print message to UI.

        */

        virtual TInt PopupMsg( const TDesC& /* aLine1 */, 

                               const TDesC& /* aLine2 */, 

                               TInt /* aTimeInSecs */ )

            { return KErrNotSupported; };

        /**

        * Function is called to print message to UI

        * and wait key pressing.

        */

        virtual TInt PopupMsg( const TDesC& /* aLine1 */, 

                               const TDesC& /* aLine2 */, 

                               TInt /* aTimeInSecs */,

                               TKeyCode& /* aKey */,

                               TRequestStatus& /* aStatus */ )

            { return KErrNotSupported; };

       /**

        * Function is called to close instances.

        */

        virtual void Close( TInt /* aHandle */ ){};

    public: // Functions from base classes

    private: 

    private:

    private: // Data

		CUIStore*					    iUIStore;

    };

// CLASS DECLARATION

// DESCRIPTION

// CTestSetInfo contains test set information

class CTestSetInfo 

    :public CBase  

    {

    public: // Enumerations

    private: // Enumerations

    public:  // Constructors and destructor

        /**

        * NewL is first phase of two-phased constructor.

        */

        static CTestSetInfo* NewL( const TDesC& aName );

        /**

        * Destructor of CStartedTestCase.

        */

        virtual ~CTestSetInfo();

    public: // New functions

        /**

        * Get test set name.

        */

        inline const TDesC& Name() const 

            { return *iName; };

        /**

        * Get test cases.

        */

        inline const RRefArray<const CTestInfo>& TestCases() const

            { return iTestCaseRefs; };

        /**

        * Add test case to set.

        */

        TInt AddTestCase( const CTestInfo& aTestInfo );

        /**

        * Insert test case to specific location.

        */

        TInt InsertTestCase( const CTestInfo& aTestInfo, TInt aPos );

        /**

        * Remove test case from set.

        */

        TInt RemoveTestCase( const CTestInfo& aTestInfo );

        /**

        * NewL is first phase of two-phased constructor.

        */

        void CopyL( const CTestSetInfo& aTestSetInfo );

        /**

        * Sets the info which test case has been started lately.

        */

        void SetLastStartedCaseIndex(TUint aLastStartedCaseIndex);

        /**

        * Gets the info which test case has been started lately.

        */

        TUint GetLastStartedCaseIndex(void);

    public: // Functions from base classes

    protected:  // New functions

    protected:  // Functions from base classes

    private:   // Functions from base classes

        /** 

        * C++ default constructor.

        */

        CTestSetInfo();       

        /**

        * By default Symbian OS constructor is private.

        */

        void ConstructL( const TDesC& aName );

    public:     // Data

    protected:  // Data

        // None

    private:    // Data

        RRefArray<const CTestInfo>      iTestCaseRefs;

        RPointerArray<CTestInfo>        iTestCases;

        HBufC*                          iName;

        // Which test case was started as a last one (index)

        TUint                           iLastStartedCaseIndex;

    public:     // Friend classes

        // None

    protected:  // Friend classes

        // None

    private:    // Friend classes

        // None

    };

#endif // UISTOREIF_H

// End of File