S60 3 2 Directory Localizer API Specification C: API description

S60 3 2 Directory Localizer API Specification C: API description
- Use cases
- API class structure
  - Directory Localizer resource and directory resource

Directory Localizer API is a library API, which provides an interface class to utilize directory localization. With directory localization, a localized name and a specified icon are combined with a directory. For example, the image folder is shown as “Image”, but its full path may be C:\\Data\\Images\\.

Use cases

The most common use cases of Directory Localizer API are the following:

Defining Directory Localizer in a resource file
Initializing Directory Localizer
Retrieving the localized attributes of a directory

API class structure

The main classes of Directory Localizer API are shown in the figure below.

Figure 1: Class diagram of CDirectoryLocalizer

The class CDirectoryLocalizer is derived from CBase.

The class CDirectoryLocalizer is used to instantiate the Directory Localizer instance by reading the resource and make the localization for an absolute path.

Directory Localizer resource and directory resource

A Directory Localizer resource contains an array of directory resources. The following table gives a detailed description of the fields in a directory resource.

Label	Meaning
`LTEXT fullPath`	Full path of the directory.
`LTEXT localizedName`	Localized name.
`LTEXT extraData`	Extra data, for example localized name for another layout.
`WORD iconIndex`	Index of an icon.