--- 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 <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
+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 <avkon.rsg>
+<codeblock id="GUID-E27A3CE4-3058-4DEC-B298-675CB1028682" xml:space="preserve">#include <avkon.rsg>
</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 <appinfo.rh>
+<codeblock id="GUID-DB2EF2AB-24B9-4B0A-B691-E2BB54214132" xml:space="preserve">#include <appinfo.rh>
</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