2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
3 <!-- This component and the accompanying materials are made available under the terms of the License |
3 <!-- This component and the accompanying materials are made available under the terms of the License |
4 "Eclipse Public License v1.0" which accompanies this distribution, |
4 "Eclipse Public License v1.0" which accompanies this distribution, |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
6 <!-- Initial Contributors: |
6 <!-- Initial Contributors: |
7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-CBB00F6A-CBA7-4872-B0A1-A86A863725F5" xml:lang="en"><title>Precompiled |
9 --> |
10 resource values available from the Symbian platform</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
10 <!DOCTYPE concept |
11 <p>The Symbian SDK provides a generated resource header file that contains |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 symbolic IDs to resources in the Symbian platform for use in your code. The |
12 <concept id="GUID-CBB00F6A-CBA7-4872-B0A1-A86A863725F5" xml:lang="en"><title>Precompiled |
13 file with the symbolic IDs is the <parmname>avkon.rsg</parmname> file and |
13 resource values available from the Symbian platform</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 it is in the <parmname>./epoc32/include</parmname> folder. The file contains |
14 <p>The Symbian platform provides a generated resource header file that |
|
15 contains symbolic IDs to resources in the Symbian platform for use in your |
|
16 code. The file with the symbolic IDs is the <parmname>avkon.rsg</parmname> file |
|
17 and it is in the <parmname>./epoc32/include</parmname> folder. The file contains |
15 commonly used resource structures for your resource file declarations.</p> |
18 commonly used resource structures for your resource file declarations.</p> |
16 <p>A common example is the <parmname>R_AVKON_SOFTKEYS_OPTIONS_EXIT</parmname> symbolic |
19 <p>A common example is the <parmname>R_AVKON_SOFTKEYS_OPTIONS_EXIT</parmname> symbolic |
17 ID, which maps to the <parmname>CBA</parmname> resource that results in the |
20 ID, which maps to the <parmname>CBA</parmname> resource that results in the |
18 softkeys <parmname>Options</parmname> and <parmname>Exit</parmname>. The <parmname>Options</parmname> softkey |
21 softkeys <parmname>Options</parmname> and <parmname>Exit</parmname>. The <parmname>Options</parmname> softkey |
19 is bound to a command that results in the application framework opening the |
22 is bound to a command that results in the application framework opening the |
20 options menu based on the <parmname>MENU_PANE</parmname> resource. The <parmname>Exit</parmname> softkey |
23 options menu based on the <parmname>MENU_PANE</parmname> resource. The <parmname>Exit</parmname> softkey |
21 returns the <parmname>EAknSoftkeyExit</parmname> command, which would need |
24 returns the <parmname>EAknSoftkeyExit</parmname> command, which would need |
22 to be handled in the appropriate place for <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">command |
25 to be handled in the appropriate place for <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">command |
23 handling</xref> in your application architecture. Note that the Symbian platform |
26 handling</xref> in your application architecture. </p> |
24 enumerations are in the avkon.hrh file, |
27 <note> |
25 which is in the <parmname>/epoc32/include</parmname> folder. In general, you |
28 <p>The Symbian platform enumerations are in the <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/avkon_8hrh.html" format="application/java-archive"><parmname>avkon.hrh</parmname></xref> file, |
26 can map the commands returned from the CBA options by comparing the names |
29 which is in the <parmname>/epoc32/include</parmname> folder. </p> |
27 of the symbolic IDs to the symbolic names in the enumerated list.</p> |
30 </note> |
|
31 <p>In general, you can map the commands returned from the CBA options by |
|
32 comparing the names of the symbolic IDs to the symbolic names in the enumerated |
|
33 list.</p> |
28 <p>Other symbolic IDs for other purposes are also available in the <parmname>avkon.rsg</parmname> file.</p> |
34 <p>Other symbolic IDs for other purposes are also available in the <parmname>avkon.rsg</parmname> file.</p> |
29 <p>When the precompiled resources fit the needs of your application, you |
35 <p>When the precompiled resources fit the needs of your application, you |
30 can use them to access already existing resource structures. </p> |
36 can use them to access already existing resource structures. </p> |
31 <p>For examples of how these symbolic IDs are used, see</p> |
37 <p>For examples of how these symbolic IDs are used, see</p> |
32 <ul> |
38 <ul> |