As noted in Resource file structure,
if the NAME
is given, it must be the first statement
in the resource file.
After the NAME
statement, resource files must begin
with the following three RESOURCE
statements:
RESOURCE RSS_SIGNATURE
RESOURCE TBUF
RESOURCE TBUF RESOURCE EIK_APP_INFO
The RSS_SIGNATURE
resource is used to declare the
version number of the resource file. Leave this blank. The syntax is as follows:
RESOURCE RSS_SIGNATURE { signature = value }
where signature is a LONG
value.
By default the signature is set to 0.
For an example, see helloworldbasic.rss.
For more information on RSS_STRUCTURE, see BA_RSS_SIGNATURE in the Symbian OS Library.
The TBUF
resource may be used to declare a file
name for use by the document class if it is stated that the StoreL
and RestoreL
of
the document class is called. Otherwise, it may be left blank. The syntax
is as follows:
RESOURCE TBUF { buf="NAME"; }
where buf
is one non-zero terminating string.
For an example, see helloworldbasic.rss.
Note that the TBUF structure is declared in badef.rh
,
which is included in the uikon.rh
file. For more information
on the TBUF resource, see TBUF in
the Symbian OS Library.
The EIK_APP_INFO
resource defines the objects
used in the application GUI. Note that not all possible objects need to be
declared. The syntax is as follows:
RESOURCE EIK_APP_INFO { menubar = value2; cba = value5; status_pane = value6; }
where:
menubar
defines the menubar resource
cba
defines the softkeys resource
status_pane
defines the status pane
resource
All values refer to resources defined either in the resource file or
in a generated resource header file (.rsg
) included in
the resource file. Note that if an element is not defined, then it is not
used. For example:
RESOURCE EIK_APP_INFO { menubar=r_name4; cba=R_AVKON_SOFTKEYS_OPTIONS_EXIT; }
sets the application to use the menu bar defined by the RESOURCE
statement
with the namer_name4
, and creates the softkey options Options
and Exit
in
the control button area.
For an example, see helloworldbasic.rss.
For more information on the control button area softkeys provided by the S60 platform, see Precompiled resource values available from the S60 platform and S60 UI Style Guide.