/*

* 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:  This class is used to provide localized names

*

*/

#ifndef CGFLMITEMLOCALIZER_H

#define CGFLMITEMLOCALIZER_H

// INCLUDES

#include <e32base.h>

// FORWARD DECLARATIONS

class CDirectoryLocalizer;

// CLASS DECLARATION

/**

*  This class is used to provide localized names to files and directories

*

*  @lib GFLM.lib

*  @since 2.0

*/

NONSHARABLE_CLASS(CGflmItemLocalizer) : public CBase

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CGflmItemLocalizer* NewL();

        /**

        * Destructor.

        */

        virtual ~CGflmItemLocalizer();

    public: // New functions

        /**

        * Get the localized name of a file or a directory by it's path.

        * Works only in main thread context.

        * @since 2.0

        * @param aPath A descriptor containing the full path to be localized

        * @return A TPtrC object containing the localized name. KNullDesC

        *         if no localized name is defined.

        */

        TPtrC Localize( const TDesC& aPath ) const;

        /**

        * Get the localized name of a file or a directory by it's path

        * Works only in work thread context.

        * @since 3.2

        * @param aPath A descriptor containing the full path to be localized

        * @return A TPtrC object containing the localized name. KNullDesC

        *         if no localized name is defined.

        */

        TPtrC LocalizeFromWorkThread( const TDesC& aPath ) const;

        /**

        * Setups localizer for work thread

        * Works only in work thread context.

        * @since 3.2

        */

        void SetupWorkThreadLocalizerL();

        /**

        * Releases localizer used by work thread

        * Works only in work thread context.

        * @since 3.2

        */

        void ReleaseWorkThreadLocalizer();

    private:

        /**

        * C++ default constructor.

        */

        CGflmItemLocalizer();

        void ConstructL();

        TPtrC Localize(

            CDirectoryLocalizer& aLocalizer, const TDesC& aPath ) const;

    private:    // Data

        // Own: For localising in main thread context

        CDirectoryLocalizer* iLocalizer;

        // Own: For localising in work thread context

        CDirectoryLocalizer* iWorkThreadLocalizer;

    };

#endif      // CGFLMITEMLOCALIZER_H

// End of File