/*

* Copyright (c) 2005-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:      File sharing list class definition for Home Network

 *

*/

#ifndef UPNPAPPFILESHARINGLIST_H

#define UPNPAPPFILESHARINGLIST_H

//  INCLUDES

#include <aknsettingitemlist.h> // base class

#include <AknWaitNoteWrapper.h> // base class MAknBackgroundProcess

// FORWARD CLASS DECLARATION

class CUPnPFileSharingEngine;

class CUPnPAppWizard;

// CONSTANTS

const TInt KMaxTextSettingItemLenght = 128;

/**

 *  Settings list class declaration

 *  @since S60 3.1

 */

NONSHARABLE_CLASS( CUPnPAppFileSharingList )

    : public CAknSettingItemList

    , public MAknBackgroundProcess

    {

private:

    /**

     * The internal phases of wait note when changing sharing state

     */

    enum TSharingStarting

        {

        EPhaseNotActive,

        EPhaseProcessing,

        EPhaseCompleted

        };

public:  // Constructors and destructor

    /**

     * Two-phased constructor.

     */

    static CUPnPAppFileSharingList* NewL(

        CUPnPFileSharingEngine* aFileSharingEngine );

    /**

     * Destructor.

     */

    virtual ~CUPnPAppFileSharingList();

public: // New functions

    /**

     * From CAknSettingItemList, this launches the setting page.

     * @since S60 3.1

     * @param aIndex, index of selected list item

     * @param aCalledFromMenu, indicates if editing is called

     *        trough menu or from keyboard

     */

    void  EditItemL (TInt aIndex, TBool aCalledFromMenu);

    /**

     * Reads data from storage to member variables

     * @since S60 3.1

     */

    void LoadDataFromEngineL();

public: //From MUPnPFileSharingEngineObserver

    /**

     * Function informs when file sharing was enabled or disabled

     * @since S60 3.1

     * @param aEngine File sharing engine

     * @param aError, error code

     * @param aPhase ETrue if current phase is sharing activation,

     * otherwise EFalse

     */

    void HandleSharingStatus( 

        CUPnPFileSharingEngine& aEngine, 

        TInt aError, 

        TBool aPhase );

    /**

     * Callback to inform if connection has been lost

     * @since S60 3.1

     * @param aEngine File sharing engine

     */ 

    void HandleSharingConnectionLost( 

        CUPnPFileSharingEngine& aEngine );

public:

    /**

     * Processes progress information and sets secondary texts according to

     * received progress

     * @since S60 3.1

     * @param aProgressInfo, Type containg the progress information

     */

    void SetFilesharingTextsL(

        const RArray<TUpnpProgressInfo>& aProgressInfo );

    /**

     * Sets the default secondary texts if no sharing is ongoing

     * @since S60 3.1

     * @param aMediaType, Type of the media

     * @param aState, State of the selection

     */

    void SetDefaultSecondaryTextsL(

        const TInt& aMediaType,

        const TInt& aState );

    /**

     * Sets the secondary texts id there is sharing ongoing

     * @since S60 3.1

     * @param aMediaType, Type of the media

     * @param aProgress, The value of progress in percents

     */

    void SetProgressSecondaryTextsL(

        const TInt& aMediaType,

        const TInt& aProgress );

    /**

     * Update the visibity of item ,when the list is switched foregroud.

     */

     void UpdateVisibitySettingItemL();

protected:

    /**

     * From CAknSettingItemList

     */

    void HandleResourceChange( TInt aType );

    /**

     * From CoeControl

     */

    void FocusChanged(

        TDrawNow  aDrawNow );

protected:

    /**

     * From MAknBackgroundProcess

     */

    void  StepL();

    /**

     * From MAknBackgroundProcess

     */

    TBool  IsProcessDone() const;

private:

    /**

     * C++ default constructor.

     */

    CUPnPAppFileSharingList();

    /**

     * By default Symbian 2nd phase constructor is private.

     * @param aFileSharingEngine, engine pointer

     */

    void ConstructL( CUPnPFileSharingEngine* aFileSharingEngine );

    /**

     * From CAknSettingItemList, Framework method to create a setting item.

     * @since S60 3.1

     * @param aIdentifier,  list item id to be created

     * @return CAknSettingItem, pointer to list item

     */

    CAknSettingItem* CreateSettingItemL( TInt aIdentifier );

    /**

     * Create and show the wait note when starting sharing

     * @since S60 3.1

     */

    void ShowWaitNoteL();

private: // Data

    /**

     * list item text for visual albums

     */

    TBuf<KMaxTextSettingItemLenght>  iVisualAlbums;

    /**

     * list item text for playlists

     */

    TBuf<KMaxTextSettingItemLenght>  iPlayLists;

    /**

     * visibility setting item value

     */

    TInt iVisibility;

    /**

     *access point id setting item value

     */

    TInt iIapId;

    /**

     * engine pointer

     */

    CUPnPFileSharingEngine* iFileSharingEngine;

    /**

     * Indicator if wizard is run to update UI

     */

    TBool iWizardRun;

    /**

     * The state of sharing activation for progress note

     */

    TInt iStartingSharing;

    /**

     * Pointer to wizard

     */

    CUPnPAppWizard* iWizard;

    };

#endif      // UPNPAPPFILESHARINGLIST_H

// End of File