<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

	Nokia Corporation - initial contribution.

Contributors: 

-->  <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-6AD1DA34-EA3D-4EC9-A667-390507B4D6CB" xml:lang="en"><title>helloworldbasic.rss</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>

<p>In the Symbian platform, resource files are used to define UI components

such as status panes, <xref href="GUID-A4F3738C-CBFD-4151-9132-26FE05966715.dita">CBA

(Control Button Area) buttons</xref>, <xref href="GUID-5918ED8A-B26B-41A0-94A6-AB6D51BF80A1.dita">menu

bars</xref>, <xref href="GUID-DAC32BB9-C0EB-42FF-A596-C2F1A90A4BD7.dita">views</xref>,

dialogs, strings, and constants used in applications. The UI components consist

of data structures that are defined in resource files, and then are called

from the classes controlling the UI implementation. When UI component implementation

is split into these two approaches, it means that resources can be recompiled,

for example for new languages, without having to recompile the application

code.</p>

<p>For more information about resource files, see <xref href="GUID-0FB60233-993A-4BF2-9E8C-E03AD092359B.dita">Managing

resource files</xref>.</p>

<codeblock xml:space="preserve" id="GUID-5FFA294E-190E-41AE-BDA3-EE3F2E84F2E6">//  RESOURCE IDENTIFIER

NAME HEWB    // 4 letter ID

</codeblock>

<p>This NAME statement defines the mandatory identifier for this resource

file, which is unique within this application. For more information, see <xref href="GUID-EC49B54F-7724-433B-BD7F-201DE3B7DAA6.dita">Resource

file structure</xref>.</p>

<codeblock xml:space="preserve" id="GUID-6A156720-EBC9-4D2E-B6B7-196DFAEBB518">//  INCLUDES

#include <eikon.rh>

#include <avkon.rh>

</codeblock>

<p>These are preprocessor statements for <parmname>EIKON</parmname> and <parmname>AVKON</parmname> files

provided with the SDK in the <parmname>./Epoc32/include</parmname> subfolder

that are required for data structures used in the resource file. For more

on the available preprocessor statements in resource files, see <xref href="GUID-EC49B54F-7724-433B-BD7F-201DE3B7DAA6.dita">Resource

file structure</xref>.</p>

<codeblock xml:space="preserve" id="GUID-E27A3CE4-3058-4DEC-B298-675CB1028682">#include &lt;avkon.rsg&gt;

</codeblock>

<p>These is a preprocessor statement for a generated resource file provided

with the SDK in the <parmname>./Epoc32/include</parmname> subfolder that provides

a list of symbolic IDs that point to compiled resources. For more on Symbian

precompiled options, see <xref href="GUID-CBB00F6A-CBA7-4872-B0A1-A86A863725F5.dita">Precompiled

resource values available from the Symbian platform</xref>.</p>

<codeblock xml:space="preserve" id="GUID-DB2EF2AB-24B9-4B0A-B691-E2BB54214132">#include &lt;appinfo.rh&gt;

</codeblock>

<p>This is a preprocessor statement for an <parmname>AVKON</parmname> file

provided with the SDK in the <parmname>./Epoc32/include</parmname> subfolder

that is required for the data structure used for the localizable information

for the application registration resource file.</p>

<codeblock xml:space="preserve" id="GUID-3664CD24-DCE2-437F-B833-7E459CECD684">#include "HelloWorldBasic.hrh"</codeblock>

<p>This is a preprocessor statement for the <i>HelloWorldBasic</i> custom

command IDs. For more on custom command IDs, see <xref href="GUID-D52E98C3-F5EE-4CE1-A4F5-2EF41A066B8A.dita">Creating

resource header files</xref>.</p>

<codeblock xml:space="preserve" id="GUID-F434F19C-2BEF-4E95-BF16-35813A19FD0E">#include "HelloWorldBasic.rls"

</codeblock>

<p>This is a preprocessor statement for the file used to manage building

the localized strings for the <i>HelloWorldBasic</i> application. For more

on internationalization and localization, see <xref href="GUID-E111C4E8-1342-4E87-ACB4-5B630AF1501C.dita">Internationalization

and localization</xref>.</p>

<codeblock xml:space="preserve" id="GUID-51D40318-84BB-49A7-9D1E-E28118AD71A6">//  RESOURCE DEFINITIONS

// -----------------------------------------------------------------------------

//

//    Define the resource file signature

//    This resource should be empty.

//

// -----------------------------------------------------------------------------

//

RESOURCE RSS_SIGNATURE

    {

    }

</codeblock>

<p>This is the required <parmname>RESOURCE</parmname> definition that indicates

the version of this resource file. For this application, no version is defined.</p>

<codeblock xml:space="preserve" id="GUID-C70BA7AA-2AD2-4876-8F14-AE4E73D2BB5E">// -----------------------------------------------------------------------------

//

//    Default Document Name

//

// -----------------------------------------------------------------------------

//

RESOURCE TBUF r_default_document_name

    {

    buf="HEWB";

    }

</codeblock>

<p>This is the required <parmname>RESOURCE</parmname> definition that defines

the name used if the <parmname>helloworldbasicdocument</parmname> class needs

to store a document.</p>

<codeblock xml:space="preserve" id="GUID-B0907BE0-D5B4-47E9-86AB-730C67F2AC8E">// -----------------------------------------------------------------------------

//

//    Define default menu and CBA key.

//

// -----------------------------------------------------------------------------

//

RESOURCE EIK_APP_INFO

    {

    menubar = r_helloworldbasic_menubar;

    cba = R_AVKON_SOFTKEYS_OPTIONS_EXIT;

    }

</codeblock>

<p>This is the required <parmname>RESOURCE</parmname> definition that defines

the resource used for constructing the menu bar and the Control Button Area

(CBA) buttons used in the application. The menu bar is constructed later in

this resource file. The CBA buttons declaration uses a precompiled symbolic

ID from the <parmname>avkon.rsg</parmname> file, which in turns points to

a compiled resource that provides an <parmname>Options</parmname> text above

the left softkey and an <parmname>Exit</parmname> text above the right softkey.

The application framework handles the event generated by selection of the <parmname>Options</parmname> softkey

and opens the <parmname>MENU_PANE</parmname> resource. Selection of the <parmname>Exit</parmname> softkey

generates a <parmname>EAknSoftkeyExit</parmname> event that needs to be handled

by your code. For more information on event handling, see <xref href="GUID-A9330FEF-C559-4E2B-B064-0151FDADEA8C.dita">Event

handling</xref>.</p>

<codeblock xml:space="preserve" id="GUID-1D25FC90-4454-4FE2-9306-60B8BC2AFBA3">// -----------------------------------------------------------------------------

//

//   r_helloworldbasic_menubar

//   Menubar for HelloWorldBasic example

//

// -----------------------------------------------------------------------------

//

RESOURCE MENU_BAR r_helloworldbasic_menubar

    {

    titles =

        {

        MENU_TITLE { menu_pane = r_helloworldbasic_menu; }

        };

    }

</codeblock>

<p>This <parmname>RESOURCE</parmname> definition defines the <parmname>r_helloworldbasic_menubar</parmname> menu

bar declared in <parmname>EIK_APP_INFO</parmname>. The <parmname>MENU_TITLE</parmname> statement

maps to the <parmname>Options</parmname> softkey, which opens the defined <parmname>MENU_PANE</parmname> resources

when selected.</p>

<codeblock xml:space="preserve" id="GUID-18A6F8CA-F09E-4E0F-8F36-424090D084D4">// -----------------------------------------------------------------------------

//

//   r_helloworldbasic_menu

//   Menu for "Options"

//

// -----------------------------------------------------------------------------

//

RESOURCE MENU_PANE r_helloworldbasic_menu

    {

    items =

        {

        // added the new Options menu command here

        MENU_ITEM

                {

                command = EHelloWorldBasicCommand1;

                txt = STRING_hewb_command1;

                },

        MENU_ITEM

                {

                command = EHelloWorldBasicCommand2;

                txt = STRING_hewb_command2;

                },

        MENU_ITEM

                {

                command = EHelloWorldBasicCommand3;

                txt = STRING_r_hewb_command3;

                },

	MENU_ITEM

                {

                command = EAknSoftkeyExit;

                txt = STRING_r_hewb_exit;

                }

        };

    }

</codeblock>

<p>This <parmname>RESOURCE</parmname> definition defines the <parmname>r_helloworldbasic_menu</parmname> menu

opened when <parmname>Option</parmname> is selected. Four menu items are offered: <parmname>Hello</parmname>, <parmname>Hello

from file</parmname>, <parmname>Hello from edit</parmname>, and <parmname>Exit</parmname>.

The <parmname>command</parmname> definitions indicate which event is returned

by the application framework when the option is selected and the <parmname>txt</parmname> declarations

provide the strings used in the menu. The enumerated <parmname>command</parmname> command

IDs here are listed in the <parmname>helloworldbasic.hrh</parmname> file,

with the exception of <parmname>EAknSoftkeyExit</parmname>, which is a command

ID available from <parmname>avkon.hrh</parmname>.</p>

<codeblock xml:space="preserve" id="GUID-D3AA64A7-6A43-426F-8D49-874283903FF1">// -----------------------------------------------------------------------------

//

// Resources for messages.

//

// -----------------------------------------------------------------------------

//

RESOURCE TBUF32 r_hewb_command1_text { buf=STRING_r_hewb_command1_text; }

RESOURCE TBUF32 r_hewb_file_text { buf=STRING_r_hewb_file_text; }

RESOURCE TBUF32 r_hewb_caption_string { buf=STRING_r_hewb_caption_string; }

</codeblock>

<p>These <parmname>RESOURCE</parmname> definitions define <parmname>TBUF32</parmname> resources

that can be read in the application implementation code later with the <parmname>StringLoader</parmname> class.</p>

<codeblock xml:space="preserve" id="GUID-4205A985-F5DD-4EFE-9EAB-56C2188802D4">// ---------------------------------------------------------------------------- 

//

// r_helloworldbasic_localisable_app_info

//

// ---------------------------------------------------------------------------- 

//

RESOURCE LOCALISABLE_APP_INFO r_helloworldbasic_localisable_app_info

    {

    short_caption = STRING_hewb_caption_string;

    caption_and_icon = 

    CAPTION_AND_ICON_INFO

        {

        caption = STRING_hewb_caption_string;

        number_of_icons = 1;

	   	icon_file = "\\resource\\apps\\Helloworldbasic_aif.mif";

	    };

    }

</codeblock>

<p>This <parmname>RESOURCE</parmname> definition defines the localizable

information for the <i>HelloWorldBasic</i> registration file, where:</p>

<ul>

<li><p><parmname>r_helloworldbasic_localisable_app_info</parmname> is

the resource identifier</p></li>

<li><p><parmname>STRING_hewb_caption_string</parmname> is the symbolic

ID for <parmname>HelloWorld</parmname>, which is used for both the short and

long caption</p></li>

<li><p>there is one icon for <i>HelloWorldBasic</i> and it is in

the <parmname>\\resource\\apps\\Helloworldbasic_aif.mif</parmname> file</p>

</li>

</ul>

<codeblock xml:space="preserve" id="GUID-730600E4-43F1-45ED-B713-FCFDD6F56FB3">// ----------------------------------------------------------------------------

//

// r_dialog_text_edit_query

//

// ----------------------------------------------------------------------------

//

RESOURCE DIALOG r_dialog_text_edit_query

    {

    flags = EGeneralQueryFlags;

    buttons = R_AVKON_SOFTKEYS_OK_CANCEL;

    items =

        {

        DLG_LINE

            {

            type = EAknCtQuery;

            id = EGeneralQuery;

            control = AVKON_DATA_QUERY

                {

                layout = EDataLayout;

                label = "";

                control = EDWIN

                    {

                    width = 32;

                    maxlength = 32;

                     lines = 1;

                    };

                };

            }

        };

    }

// End of File

</codeblock>

<p>This <parmname>RESOURCE</parmname> definition defines the resource required

for a dialog used in the<i>HelloWorldBasic</i> application. For more information

on defining <parmname>DIALOG</parmname> resources, see Using Dialog API.</p>

</conbody></concept>