/*

* Copyright (c) 2005 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: A converter representation of the operation class. It provides an interface

*  for operations that are performed in small synchronous steps.

*

*/

#ifndef CPOSLMCONVERTEROPERATION_H

#define CPOSLMCONVERTEROPERATION_H

//  INCLUDES

#include <EPos_CPosLmOperation.h>

#include "EPos_TPosLmConvOperationStatus.h"

// FORWARD DECLARATION

// CLASS DECLARATION

/**

*  A converter representation of the operation class. It provides an interface

*  for operations that are performed in small synchronous steps.

*/

class CPosLmConverterOperation : public CPosLmOperation

    {

    public:  // Constructors and destructor

        /**

        * Destructor.

        */

        virtual ~CPosLmConverterOperation();

    public: // From base classes

        /**

        * From CPosLmOperation.

        *

        * Performs one step of the operation asynchronously.

        *

        * @param aStatus The request status. Will be completed when the step

        *   has been performed. The request status will be @p KRequestPending

        *   if the step has not completed. It will be

        *   @p KPosLmOperationNotComplete if the step has completed but more

        *   steps are needed before the operation has finished. The request

        *   status will be @p KErrNone if the operation has finished

        *   successfully. The status will be set to an error code if the

        *   operation has failed.

        * @param aProgress Will be set to the progress of the operation when the

        *   step has finished.

        */

        void NextStep(

        /* OUT */   TRequestStatus& aStatus,

        /* OUT */   TReal32& aProgress

        );

        /**

        * From CPosLmOperation.

        *

        * Synchronous execution of the operation. Performs calls to NextStepL

        * until the operation is completed.

        *

        * When this function returns, the operation has finished.

        */

        void ExecuteL();

        /**

        * Synchronous incremental execution of the operation. Performs a single

        * step of the operation synchronously.

        *

        * Leaves with an error code if something goes wrong.

        *

        * @param aProgress Will be set to the progress of the operation when

        * the step has finished.

        * @return @p KPosLmOperationNotComplete if the step has completed but

        *   more steps are needed before the operation has finished,

        *   @p KErrNone if the operation has finished successfully.

        */

        virtual TInt NextStepL(

        /* OUT */       TReal32& aProgress

        ) = 0;

        /**

        * Handles any error generated by NextStepL. Will be called when

        * NextStepL leaves. The error code is allowed to be changed, if

        * necessary.

        *

        * @param aError An error code generated by NextStepL.

        */

        virtual void HandleError(

        /* IN/OUT */    TInt& aError

        ) = 0;

        /**

        * Handles a completed operation that has been successfully completed.

        * Will be called when NextStepL returns with KErrNone.

        *

        * For CPosLmConverterOperation this function is empty.

        */

        virtual void HandleOperationCompleted();

    protected:

        /**

        * C++ default constructor.

        */

        CPosLmConverterOperation();

        /**

        * Symbian 2nd phase constructor.

        */

        void BaseConstructL();

        /**

        * Retrieves the current progress of the operation.

        * Note: if called from the @p NextStepL function, this function returns

        * the progress of the previous step.

        * @return The progress of the operation.

        */

        TReal32 Progress();

    private:

        // By default, prohibit copy constructor

        CPosLmConverterOperation( const CPosLmConverterOperation& );

        // Prohibit assigment operator

        CPosLmConverterOperation& operator= ( const CPosLmConverterOperation& );

    private:

        TPosLmConvOperationStatus iOperationStatus;

        TReal32 iProgress;

    };

#endif      // CPOSLMCONVERTEROPERATION_H

// End of File