/*
* Copyright (c) 2002,2003 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:  Loads resources from file. 
*
*/


#ifndef CPSUIRESOURCELOADER_H
#define CPSUIRESOURCELOADER_H

//  INCLUDES
#include <e32std.h>
#include <e32base.h>

// FORWARD DECLARATIONS
class RConeResourceLoader;

// CLASS DECLARATION
/**
* A helper class for loading dll-specific resource files on demand. 
* Searches and loads the specified resource file to the CONE environment 
* (CCoeEnv) -object (accessible as iCoeEnv in CONE-related classes). 
* After calling NewL the user can access the resources directly via 
* the CONE environment. The resources in the file are accessible until 
* the CPsuiResourceLoader object is destroyed. The resource file must be 
* a well-formed UIKON resource file with NAME and RSS_SIGNATURE specified.
*
* @lib psui.lib
* @since 1.0
*/
class CPsuiResourceLoader : public CBase
    {
    public:  // Constructors & destructor

         /**
         * Symbian OS 1st phase constructor. Creates and returns a new
         * resource loader object. 
         * Loads resource from any drive. If this function is succesful
         * (doesn't leave) the resources in the file are usable through
         * CCoeEnv.
         * 
         * @return new object of this class holding a reference to the
         *                      resource file.
         *
         * @exception KErrNotFound  if the resource file is not found.
         * @exception KErrNoMemory  if out of memory.
         * @exception error         from CCoeEnv::AddResourceFileL.
         */
        IMPORT_C static CPsuiResourceLoader* NewL();

         /**
         * Same as NewL, but leaves the created object onto the cleanup stack.
         * @see NewL
         */
        IMPORT_C static CPsuiResourceLoader* NewLC();

         /* Destructor */
        ~CPsuiResourceLoader();

    protected:  // private constructor

        void ConstructL();

    private:  // member variables

        // CONE resource loader
        RConeResourceLoader* iResourceLoader;
    };

#endif  // CPSUIRESOURCELOADER_H

// End of File