/*

* Copyright (c) 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:   Wraps functions for showing some global dialogs.

*

*/

#ifndef CIAUPDATERDIALOG_H

#define CIAUPDATERDIALOG_H

//  INCLUDES

#include <e32base.h>

#include <f32file.h>

#include <barsc.h>

#include <AknGlobalNote.h>

// FORWARD DECLARATIONS

class MIAUpdaterCancelObserver;

/**

* Class for showing the global note dialog when installing self update.

* 

*  @code   

*  @endcode

*  @lib 

*  @since S60 

*/

class CIAUpdaterDialog : public CActive

    {

public:  

    /**

     * Two-phased constructor.

     */

    static CIAUpdaterDialog* NewL( RFs& aFs, MIAUpdaterCancelObserver& aObserver ); 

    /**

     * Two-phased constructor.

     */

    static CIAUpdaterDialog* NewLC( RFs& aFs, MIAUpdaterCancelObserver& aObserver );

    /**

     * Destructor.

     */

    ~CIAUpdaterDialog();

    /**

     * Show global waiting note (during installing).

     *

     * @param Current pkg's name for wait dialog.

     * @param Current pkg's index number for wait dialog.

     * @param aTotalCount Max pkg count for wait dialog.

     */

    void ShowWaitingNoteL( const TDesC& aName, 

                           TInt aIndex, 

                           TInt aTotalCount );

    /**

     * Cancel global waiting note (after installing).

     */

    void CancelWaitingNoteL();

private:

    /**

     * Constructor.

     */  

    CIAUpdaterDialog( RFs& aFs, MIAUpdaterCancelObserver& aObserver );

    /**

     * 2nd phase constructor.

     */

    void ConstructL();

    /**

     * Read resource string.

     * @since 

     * @param aResourceId Id of the resource.

     * @return Resource buffer.

     */

    HBufC* ReadResourceLC( TInt aResourceId );    

private: // from CActive

    /**

     * Cancels async request 

     * @see CActive::DoCancel

     *

     */

    void DoCancel();

    /**

     * When the server side has finished operation, the CActive object will

     * be informed about it, and as a result RunL will be called. This function

     * well inform the observer that the operation has been completed.

     * @see CActive::RunL

     *

     */

    void RunL();

private: // data

    // Resource file.

    RResourceFile iResourceFile;

    // File server handle.        

    RFs& iFs;        

    CAknGlobalNote* iNote;

    // Dialog id for canceling dialog. 

    TInt iNoteId;

    MIAUpdaterCancelObserver* iObserver; //not owned

    };

#endif      // CIAUPDATERDIALOG_H   

// End of File