/*
* Copyright (c) 2008 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:  Interface class for WMDRM DLA UI
*
*/


#ifndef C_WMDRMDLAUI_H
#define C_WMDRMDLAUI_H

#include <e32base.h>

class CCoeEnv;
class CAknGlobalNote;
class MDesCArray;
class CGulIcon;

/**
 * Interface for wait note callback.
 */
class MWmDrmDlaWaitNoteCallback
    {
    public:
        
        /**
         * Called if user cancels the wait note
         */
        virtual void UserWaitNoteCancellation() = 0;

    };

/**
 *  WMDRM DLA UI Interface
 *
 *  @lib wmdrmdlautils.lib
 *  @since S60 v9.1
 */
NONSHARABLE_CLASS( CWmDrmDlaUi ) : public CActive
    {

    public:

        /**
         * This class must have an access to CCoeEnv,
         * otherwise it will leave with KErrNotSupported
         */
        IMPORT_C static CWmDrmDlaUi* NewL();
        IMPORT_C static CWmDrmDlaUi* NewLC();

        /**
         * Destructor.
         */
        virtual ~CWmDrmDlaUi();

        /**
         * Shows error note
         *
         * @param aTextResourceId Resource id of the text to be shown
         * @leave with standard Symbian error code in case of error
         */
        IMPORT_C void ShowErrorNoteL( TInt aTextResourceId );
        
        /**
         * Shows wait note
         *
         * @param aTextResourceId Resource id of the text to be shown
         * @param aCallback Callback that will be called, 
         *                  if user cancels the wait note. Can be NULL.
         * @leave with KErrInUse, if wait note is already shown, otherwise
         *        standard Symbian error code in case of error.
         */
        IMPORT_C void ShowWaitNoteL( TInt aTextResourceId, 
                                     MWmDrmDlaWaitNoteCallback* aCallback );
        
        /**
         * Removes wait note
         */
        IMPORT_C void RemoveWaitNote();
        
        /**
         * Shows list query
         *
         * @param aItems Item array to be shown, 
         *               ownership is transferred to the list query.
         * @param aIcons Icon array to be shown, 
         *               ownership is transferred to the list query.
         * @return Index of the user selection or -1, if user cancelled query.
         * @leave with KErrArgument, if any parameter is NULL, otherwise
         *        standard Symbian error code in case of error.
         */
        IMPORT_C TInt ShowListQueryL( MDesCArray* aItems, 
                                      CArrayPtr<CGulIcon>* aIcons );
        
    protected: // from base class CActive

        /**
        * From CActive Cancels async request.
        */
        void DoCancel();

        /**
        * From CActive Called when async request completes.
        */
        void RunL();
        
        /**
        * From CActive Called if RunL leaves.
        */
        TInt RunError( TInt aError );    
        
    private:

        CWmDrmDlaUi();
        void ConstructL();
        void CancelWaitNote();

    private: // data

        //Control environment, not owned
        CCoeEnv* iCoeEnv;
    
        // Path of the resource file
        HBufC* iWmdrmDlaUtilsResourceFile;

        // Resource offsets in CoeEnv
        TInt iWmdrmDlaUtilsResourceFileOffset;
        
        CAknGlobalNote* iGlobalNote;
        TInt iGlobalNoteId;
        HBufC* iGlobalNoteText;
        
        //Not owned
        MWmDrmDlaWaitNoteCallback* iCallback;
   
    };

#endif // C_WMDRMDLAUI_H