diff -r 2fe1408b6811 -r e1b950c65cb4 epoc32/include/coeutils.h --- a/epoc32/include/coeutils.h Tue Mar 16 16:12:26 2010 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,102 +0,0 @@ -// COEUTILS.H - -/* -* Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies). -* All rights reserved. -* This component and the accompanying materials are made available -* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members -* which accompanies this distribution, and is available -* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". -* -* Initial Contributors: -* Nokia Corporation - initial contribution. -* -* Contributors: -* -* Description: -* -*/ - - - -#ifndef __COEUTILS_H__ -#define __COEUTILS_H__ - -#include -class CCoeEnv; - -/** Provides file and path utility functions. - -@publishedAll -@released */ -class ConeUtils - { -public: - IMPORT_C static TBool FileExists(const TDesC& aFileName); - IMPORT_C static void EnsurePathExistsL(const TPtrC& aFileName); - }; - - -/** -Class encapsulates methods for opening and closing localised resource files -in the CONE environment. The actual reading of resources from an opened -resource file is done using various CCoeEnv provided resource-reading -methods. The Cone Resource Loader API consists of the RCoeResourceLoader class. - -Only one resource at a time may be opened by one RCoeResourceLoader instance. -You can use several RCoeResourceLoader instances for accessing several -resources simultaneously or use one instance and close the previous resource -before opening a new one. - -The implementation uses BaflUtils::NearestLanguageFile to search for -a localised resource in proper search order. - -Usage example: - -@code -#include - -// Get CCoeEnv instance -CEikonEnv* eikEnv = CEikonEnv::Static(); -// Initialize loader -RCoeResourceLoader rLoader(eikEnv); - -// Push resource loader to cleanup stack, so that it will always be properly -// closed when popped. -CleanupClosePushL(rLoader); - -// Open resource file -_LIT( KSampleResourceFileName, "Z:\\System\\Apps\\sample\\sample.rsc" ); -TFileName fileName(KSampleResourceFileName); -rLoader.OpenL(fileName); - -// Read a resource -iSomeArray = eikEnv->ReadDesC16ArrayResourceL(R_SOME_RESOURCE); - -// Pop and destroy rLoader from stack. -// This also calls the rLoader close function after CleanupClosePushL is used. -CleanupStack::PopAndDestroy(); // rLoader -@endcode - -@publishedAll -@released */ -NONSHARABLE_CLASS(RCoeResourceLoader) - { -public: - IMPORT_C RCoeResourceLoader(CCoeEnv& aEnv); - IMPORT_C TInt Open(TFileName& aFileName); - IMPORT_C void OpenL(TFileName& aFileName); - IMPORT_C void Close(); -private: - // Prohibit copy constructor and assigment operator because not deriving from CBase. - RCoeResourceLoader(); - RCoeResourceLoader(const RCoeResourceLoader&); - RCoeResourceLoader& operator= (const RCoeResourceLoader&); -private: - // Needed for closing - CCoeEnv& iEnv; - TInt iResourceFileOffset; - }; - - -#endif // __COEUTILS_H__