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.

Note: 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.

Note: 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: 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.