Defining +localizable registration information

diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-9F90A2F0-9C76-4871-A766-D1AE0FC42C08.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,77 @@ + + + + + +Defining +localizable registration information +

You need to register your applications +to make them visible to the application menu and to provide other information +to the underlying system. To register, you need to provide a registration +resource file that contains the non-localized information for your +application. You also need to provide the localizable registration information. +The registration resource file is compiled during the build process and included +in the .pkg file used to make the file used to make +the sis installation file.

+ + +

Localizable registration information is defined in a LOCALISABLE_APP_INFO resource +statement, which may be in a separate file or in the resource file for the +GUI resources. For a discussion of the available options for where you can +place this resource statement, see Localisable +icon/caption definition files.

To define the localizable registration information:

Determine +the requirements of your application, including deciding on whether the resource +statement should be in its own file or part of the GUI resource file.
+
Create a LOCALISABLE_APP_INFO resource. +The data structure is declared in the appinfo.rh file +in the ./epoc32/include folder, as is the CAPTION_AND_ICON_INFO structure +used in the resource. The syntax is as follows:
+
+RESOURCE LOCALISABLE_APP_INFO r_name36 + { + short_caption = ""; + CAPTION_AND_ICON_INFO + { + caption = ""; + number_of_icons =0; + icon_file = ""; + }; + view_list[]; // VIEW_DATA + group_name(KAppMaxGroupName) = ""; + } +
where
+
- r_name36 is the resource name that uniquely +identifies the RESOURCE statement in the application, and is used in the registration resource file.
  +
- short_caption indicates a shortened +version of the caption used by some UIs when screen space is limited.
  +
- caption indicates the caption used for +the application on the grid and list menu.
- number_of_icons indicates the number +of icons used for the application in the menu.
- icon_file indicates the name of the +file that contains the icon, including the path but not the drive name.
  +
+
For information on the other possible values, see Localisable +icon/caption definition files.
+
+
Add the resource +name of this resource to the localisable_resource_id in +the registration resource file.

For a commented example, see helloworldbasic.rss.

+ \ No newline at end of file