How to configure the application resource file

To create a minimal application resource file:

• Create a text file with the name of your application and the extension .rss.

• Enter the header information, including the NAME statement and the files to #include.

  NAME QAPP // The name for this resource file.

#include <eikon.rsg> // Standard resource IDs.
#include <eikon.rh> // Uikon resource STRUCT definitions and commands.
#include <qikon.rh> // Qikon resource STRUCT definitions and commands.
#include "exampleapp.hrh" // Application specific commands.

  The NAME statement must be specified before any RESOURCE statement. It is a four character word that is used to define the leading 20 bits of any resource ID. It is used to allow applications to have multiple resource files.

  The included files contain Uikon and Qikon resource STRUCT definitions and standard predefined resources and commands. The file exampleapp.hrh contains application specific commands; see How to define command IDs for more information about this file.

• Enter the following two lines. RSS_SIGNATURE can be used to specify version information — not used in this example. The TBUF is used to set the name of an application's default file. see How to set the default document file.

  // Specify version information.
RESOURCE RSS_SIGNATURE { }

// the name of the default file the application framework creates.
RESOURCE TBUF { buf="quartzapp"; }

• Enter the application GUI configuration information into an EIK_APP_INFO resource.

  RESOURCE EIK_APP_INFO
    {
    // app starts on list view
    menubar=r_qapp_list_menubar; // Resource defining the menu

    
    }

• Define the resources for the menu bar. Applications with more than one view will need to define resources for each view. Examples of how these are configured are given in the The application UI screen furniture.

• Other resource definitions are for controls, dialogs or localizable strings. Examples of how controls and dialogs are configured are given in the UIQ GUI controls catalogue.