/*

* Copyright (c) 2002-2006 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:  View for folder

*

*/

#ifndef CFILEMANAGERFOLDERSVIEW_H

#define CFILEMANAGERFOLDERSVIEW_H

//  INCLUDES

#include "CFileManagerViewBase.h"

#include <MFileManagerFolderNaviObserver.h>

// FORWARD DECLARATIONS

class CAknNavigationControlContainer;

class CAknNavigationDecorator;

class CFileManagerFolderNavigationPane;

class CAknInfoPopupNoteController;

// CLASS DECLARATION

/**

 * Folders view of the application.

 */

class CFileManagerFoldersView : public CFileManagerViewBase,

                                public MFileManagerFolderNaviObserver

    {

    public: // Custom Message IDs

        /// custom message for opening from results view

        static const TUid KOpenFromSearchResultsView;

        // For custom message use

        enum TMessage

            {

            EOpenFromSearchResultsView = 1

            };

    public:  // Constructors and destructor

        /**

         * Two-phased constructor. Leaves created view

         * to cleanup stack.

         *

         * @return Newly constructed view 

         */

        static CFileManagerFoldersView* NewLC();

        /**

         * Destructor.

         */

        ~CFileManagerFoldersView();

    public: // New declarations

        /**

         * Forwards Resource change events to view

         * @since 2.0

         * @param aType type of change

         */

        void HandleResourceChangeL( TInt aType );

        /**

         * Forwards DirectoryChange information to active view

         * @since 2.0

         */

        void DirectoryChangedL();

    private: // From CAknView

        /**

         * @see CAknView

         */

        TUid Id() const;

        /**

         * @see CAknView

         */

        void HandleCommandL( TInt aCommand );

        /**

         * @see CAknView

         */

        TKeyResponse OfferKeyEventL(

            const TKeyEvent& aKeyEvent, TEventCode aType );

        /**

         * @see CAknView

         */

        void DoActivateL(

            const TVwsViewId& aPrevViewId,

            TUid aCustomMessageId,

            const TDesC8& aCustomMessage);

        /**

         * @see CAknView

         */

        void DoDeactivate();

    private: // From CFileManagerViewBase

        /**

         * @see CFileManagerViewBase

         */

        CFileManagerContainerBase* CreateContainerL();

        /**

         * @see CFileManagerViewBase

         */

        void UpdateCbaL();

    private: // From MFileManagerFolderNaviObserver

        /**

         * @see MFileManagerFolderNaviObserver

         */

        void HandleFolderNaviEventL( TNaviEvent aEvent, TInt aValue );

    private: 

        /**

         * Refreshes title to contain name of the 

         * current folder.

         */

        void RefreshTitleL();

        /**

         * Standard C++ constructor.

         */

        CFileManagerFoldersView();

        /**

         * 2nd phase constructor.

         */

        void ConstructL();

        /**

         * Handles backstepping from the current folder.

         * @since 3.1

         * @param aBacksteps Number of backsteps to do

         */

        void BackstepL( TInt aBacksteps = 1 );

        /**

         * Gets folder name from specified folder level

         * @since 3.1

         * @param aFolderLevel Folder level

         * @return Folder name

         */

        TPtrC FolderName( const TInt aFolderLevel );

    private:    // Data

        /// Ref: Navi pane of the view

        CAknNavigationControlContainer* iNaviPane;

        /// Own: Navigation decorator for navi pane

        CAknNavigationDecorator* iNaviDecorator;

        /*

         * Ref: Navi control that draws folders in the navi pane. 

         * Ownership is given to navi pane after creation.

         */

        CFileManagerFolderNavigationPane* iNaviControl;

        // Current depth, with this folder view knows when 

        // user has gone up or down in folder tree

        TInt iFolderDepth;

        // Own: Initial folder depth.

        // View is closed after stepped back below this level.

        TInt iInitialFolderDepth;

        // Own: For showing info popups

        CAknInfoPopupNoteController* iPopupController;

    };

#endif      // CFILEMANAGERFOLDERSVIEW_H

// End of File