<?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:

Contributors: 

<p>Typically when you create an application, there are cases where you

need to create an enumerated set of command IDs (which are symbols with integer

values). These defined symbols can then be used in both your code and resource

files. Common examples of these cases, include:</p>

<ul>

<li><p>Custom command IDs used for mapping mobile device user input

based upon <parmname>Options</parmname> menu selections to command handling.

These custom command IDs are mapped to the text displayed for the command

in the <parmname>Options</parmname> menu in resource files, and then are passed

back to the application by the application framework.</p></li>

<li><p>Control IDs in dialogs to allow references to the dialog

controls from C++ code.</p>

<itemgroup>

</itemgroup>

</li>

<li><p>Application view IDs. Note that these could also be enumerated

in the header files for the views.</p></li>

<li><p>IDs for other resource structures, such as for <parmname>TABS</parmname> in

the status pane.</p></li>

</ul>

<p>These enumerated values need to be defined in a resource file, which

by convention has the extension <parmname>hrh</parmname>, The syntax is as

follows:</p>

    {

    ECmdAppTest1 = 1,

    ECmdView1Cmd1,

    ECmdView1Cmd2,

    ECmdView1Cmd3,

    ECmdView2Cmd1,

    ECmdView2Cmd2,

    ECmdView2Cmd3,

    ECmdView2Cmd4

    };</codeblock>

<p>where</p>

<ul>

<li><p><parmname>enum</parmname> is the keyword declaration the

<li><p><parmname>TCommandIds</parmname> is a label for the list

of enumerated values. This label is not used in the code or resource files.</p>

</li>

<li><p><parmname>ECmdAppTest1</parmname> is a symbol that can be

<li><p><parmname>=</parmname> is the operator used for setting the

<li><p><parmname>1</parmname> is the specific value assigned to

</ul>

<p>For more information about the use of the <parmname>enum</parmname> statement,

see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/ToolsAndUtilities94/DevTools-ref/ResourceFileFormat/Tool_Ref_RSS-file-format-ENUM.html#DevTools%2dref%2erss%2denum" format="application/java-archive">ENUM statement</xref>.</p>

</conbody></concept>