CONE -resource loader overview

Purpose

The CONE Resource Loader utility is part -of the Symbian CONE component, and it offers methods for opening and closing -resource files. The actual reading of resources from an opened resource file -is done using various CCoeEnv provided -resource-reading methods.

Architectural Relationships

This utility is implemented -as a single class, RCoeResourceLoader. -Access to the CCoeEnv instance -is required in order to use this utility.

CONE Resource Loader can -be accessed through the RCoeResourceLoader class -that is defined in the header CoeUtils.h. The actual component -is linked to the cone.dll library.

Description

Usage

CONE Resource -Loader functionality can be accessed via public methods on an RCoeResourceLoader instance.

To use, an instance of RCoeResourceLoader is -first created. Then calling either one of the open methods of RCoeResourceLoader opens -the resource file. After the resource file is no longer needed, it must be -closed.

A single instance of RCoeResourceLoader can -only have a maximum of one resource file open at any time. If multiple simultaneously -open files are required, instantiate a separate RCoeResourceLoader for -each required file.

Example

The following example shows -how to use the RCoeResourceLoader class:

#include <CoeUtils.h> - -// … Other code … - -// Get CCoeEnv instance -CEikonEnv* eikEnv = CEikonEnv::Static(); - -// Initialize loader -RCoeResourceLoader rLoader(eikEnv); - -// Open resource file -_LIT( KSampleResourceFileName, "Z:\\System\\Apps\\sample\\sample.rsc" ); -TFileName fileName(KSampleResourceFileName); -rLoader.OpenL(fileName); - -// Push resource loader to cleanup stack, so that it will always be properly -// closed when popped. -CleanupClosePushL(rLoader); - -// Read a resource -iSomeArray = eikEnv->ReadDesC16ArrayResourceL(R_SOME_RESOURCE); - -// Pop and destroy rLoader from stack. -// This also calls close on rLoader since CleanupClosePushL was used. -CleanupStack::PopAndDestroy(); // rLoader -

For more information on individual methods, please see the -reference API for RCoeResourceLoader.

+ + + + + +CONE +resource loader overview +

Purpose

The CONE Resource Loader utility is part +of the Symbian CONE component, and it offers methods for opening and closing +resource files. The actual reading of resources from an opened resource file +is done using various CCoeEnv provided +resource-reading methods.

Architectural Relationships

This utility is implemented +as a single class, RCoeResourceLoader. +Access to the CCoeEnv instance +is required in order to use this utility.

CONE Resource Loader can +be accessed through the RCoeResourceLoader class +that is defined in the header CoeUtils.h. The actual component +is linked to the cone.dll library.

Description

Usage

CONE Resource +Loader functionality can be accessed via public methods on an RCoeResourceLoader instance.

To use, an instance of RCoeResourceLoader is +first created. Then calling either one of the open methods of RCoeResourceLoader opens +the resource file. After the resource file is no longer needed, it must be +closed.

A single instance of RCoeResourceLoader can +only have a maximum of one resource file open at any time. If multiple simultaneously +open files are required, instantiate a separate RCoeResourceLoader for +each required file.

Example

The following example shows +how to use the RCoeResourceLoader class:

#include <CoeUtils.h> + +// … Other code … + +// Get CCoeEnv instance +CEikonEnv* eikEnv = CEikonEnv::Static(); + +// Initialize loader +RCoeResourceLoader rLoader(eikEnv); + +// Open resource file +_LIT( KSampleResourceFileName, "Z:\\System\\Apps\\sample\\sample.rsc" ); +TFileName fileName(KSampleResourceFileName); +rLoader.OpenL(fileName); + +// Push resource loader to cleanup stack, so that it will always be properly +// closed when popped. +CleanupClosePushL(rLoader); + +// Read a resource +iSomeArray = eikEnv->ReadDesC16ArrayResourceL(R_SOME_RESOURCE); + +// Pop and destroy rLoader from stack. +// This also calls close on rLoader since CleanupClosePushL was used. +CleanupStack::PopAndDestroy(); // rLoader +

For more information on individual methods, please see the +reference API for RCoeResourceLoader.

\ No newline at end of file