Symbian3/PDK/Source/GUID-6AD1DA34-EA3D-4EC9-A667-390507B4D6CB.dita
changeset 5 f345bda72bc4
parent 1 25a17d01db0c
child 12 80ef3a206772
--- a/Symbian3/PDK/Source/GUID-6AD1DA34-EA3D-4EC9-A667-390507B4D6CB.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-6AD1DA34-EA3D-4EC9-A667-390507B4D6CB.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -4,61 +4,59 @@
 "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.
+    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>
+-->
+<!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/></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>
+dialogs, strings, and constants used in applications. </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
+<codeblock id="GUID-5FFA294E-190E-41AE-BDA3-EE3F2E84F2E6" xml:space="preserve">//  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
+<codeblock id="GUID-6A156720-EBC9-4D2E-B6B7-196DFAEBB518" xml:space="preserve">//  INCLUDES
 #include &lt;eikon.rh&gt;
 #include &lt;avkon.rh&gt;
 </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
+provided in the <parmname>./Epoc32/include</parmname> sub-folder. They are
+required for data structures used in the resource file. For more information
 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 id="GUID-E27A3CE4-3058-4DEC-B298-675CB1028682" xml:space="preserve">#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
+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 id="GUID-DB2EF2AB-24B9-4B0A-B691-E2BB54214132" xml:space="preserve">#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>
+provided 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 id="GUID-3664CD24-DCE2-437F-B833-7E459CECD684" xml:space="preserve">#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 id="GUID-F434F19C-2BEF-4E95-BF16-35813A19FD0E" xml:space="preserve">#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
+<codeblock id="GUID-51D40318-84BB-49A7-9D1E-E28118AD71A6" xml:space="preserve">//  RESOURCE DEFINITIONS
 // -----------------------------------------------------------------------------
 //
 //    Define the resource file signature
@@ -73,7 +71,7 @@
 </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">// -----------------------------------------------------------------------------
+<codeblock id="GUID-C70BA7AA-2AD2-4876-8F14-AE4E73D2BB5E" xml:space="preserve">// -----------------------------------------------------------------------------
 //
 //    Default Document Name
 //
@@ -88,7 +86,7 @@
 <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">// -----------------------------------------------------------------------------
+<codeblock id="GUID-B0907BE0-D5B4-47E9-86AB-730C67F2AC8E" xml:space="preserve">// -----------------------------------------------------------------------------
 //
 //    Define default menu and CBA key.
 //
@@ -99,8 +97,6 @@
     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
@@ -114,7 +110,7 @@
 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">// -----------------------------------------------------------------------------
+<codeblock id="GUID-1D25FC90-4454-4FE2-9306-60B8BC2AFBA3" xml:space="preserve">// -----------------------------------------------------------------------------
 //
 //   r_helloworldbasic_menubar
 //   Menubar for HelloWorldBasic example
@@ -128,14 +124,12 @@
         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">// -----------------------------------------------------------------------------
+<codeblock id="GUID-18A6F8CA-F09E-4E0F-8F36-424090D084D4" xml:space="preserve">// -----------------------------------------------------------------------------
 //
 //   r_helloworldbasic_menu
 //   Menu for "Options"
@@ -169,7 +163,6 @@
                 }
         };
     }
-
 </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
@@ -180,7 +173,7 @@
 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">// -----------------------------------------------------------------------------
+<codeblock id="GUID-D3AA64A7-6A43-426F-8D49-874283903FF1" xml:space="preserve">// -----------------------------------------------------------------------------
 //
 // Resources for messages.
 //
@@ -192,7 +185,7 @@
 </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">// ---------------------------------------------------------------------------- 
+<codeblock id="GUID-4205A985-F5DD-4EFE-9EAB-56C2188802D4" xml:space="preserve">// ---------------------------------------------------------------------------- 
 //
 // r_helloworldbasic_localisable_app_info
 //
@@ -223,7 +216,7 @@
 the <parmname>\\resource\\apps\\Helloworldbasic_aif.mif</parmname> file</p>
 </li>
 </ul>
-<codeblock xml:space="preserve" id="GUID-730600E4-43F1-45ED-B713-FCFDD6F56FB3">// ----------------------------------------------------------------------------
+<codeblock id="GUID-730600E4-43F1-45ED-B713-FCFDD6F56FB3" xml:space="preserve">// ----------------------------------------------------------------------------
 //
 // r_dialog_text_edit_query
 //
@@ -257,5 +250,6 @@
 </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>
+on defining <parmname>DIALOG</parmname> resources, see <xref format="html" href="specs/guides/Dialogs_API_Specification/Dialogs_API_Specification.html" scope="external">Using
+Dialog API</xref>.</p>
 </conbody></concept>
\ No newline at end of file