Required -resource file statements

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
-

RESOURCE RSS_SIGNATURE -

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.

RESOURCE TBUF -

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.

- -

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.

- -

RESOURCE EIK_APP_INFO -

The EIK_APP_INFO resource defines the objects -used in the application GUI.

- -

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.

- -

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 Symbian platform, see Precompiled -resource values available from the Symbian platform.

+ + + + + +Required resource file statements +

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

RESOURCE +RSS_SIGNATURE +

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.

RESOURCE +TBUF +

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.

+ +

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.

+ +

RESOURCE +EIK_APP_INFO +

The EIK_APP_INFO resource defines the +objects used in the application GUI.

+ +

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.

+ +

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 Symbian platform, see Precompiled resource values available from the Symbian platform.

\ No newline at end of file