Symbian3/PDK/Source/GUID-86AB2626-27F1-5761-85F7-5644C5D0A675.dita
changeset 12 80ef3a206772
parent 5 f345bda72bc4
--- a/Symbian3/PDK/Source/GUID-86AB2626-27F1-5761-85F7-5644C5D0A675.dita	Fri Jul 02 12:51:36 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-86AB2626-27F1-5761-85F7-5644C5D0A675.dita	Fri Jul 16 17:23:46 2010 +0100
@@ -1,71 +1,65 @@
-<?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-86AB2626-27F1-5761-85F7-5644C5D0A675" xml:lang="en"><title>Creating
-a Control Panel Application</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<section><title>Introduction</title> <p>A control panel application is used
-to modify system settings. To create a control panel application a registration
-resource file is required which contains information about the application
-UID and the name of the application’s executable. </p> <p> <b>Note</b>: You
-need to create the registration resource file and specify its source and destination
-path in the <filepath>mmp</filepath> file. </p> </section>
-<section><title>Procedure</title> <p>The following procedure describes how
-to prepare the registration resource file and create a control panel application: </p> <ol id="GUID-70B60865-FC75-5A84-9FF2-F826481065AA">
-<li id="GUID-5CDEA94D-5B9A-5A93-9012-EC5DAD6A3BCE"><p>Define the attributes
-of the control panel application in the registration resource file. </p> <p>The
-attributes of the <codeph>APP_REGISTRATION_INFO</codeph> resource must have
-the <codeph>KAppIsControlPanelItem</codeph> attribute as shown in the code
-snippet: </p> <codeblock id="GUID-BF23DB83-177D-5165-87C3-E7D167E1A238" xml:space="preserve">#include &lt;appinfo.rh&gt;
-UID2 KUidAppRegistrationResourceFile
-UID3 0x23256ADE
-RESOURCE APP_REGISTRATION_INFO
-    {    
-    app_file = app_CTRL2;
-    attributes=KAppIsControlPanelItem;
-    }</codeblock> </li>
-<li id="GUID-B097566C-1F40-5218-9CCD-13D882CB646F"><p>In the source code of
-the application, create an instance of the <xref href="GUID-4FB064FC-210C-384A-BE92-35CA399B34C3.dita"><apiname>CApaSystemControlList</apiname></xref> class
-using the <xref href="GUID-4FB064FC-210C-384A-BE92-35CA399B34C3.dita#GUID-4FB064FC-210C-384A-BE92-35CA399B34C3/GUID-68F9CFBD-C7FE-3AAE-92E1-DA4677D50D31"><apiname>CApaSystemControlList::NewL()</apiname></xref> function to create
-and initialize a control panel application list as shown in the code snippet.
-The <xref href="GUID-4FB064FC-210C-384A-BE92-35CA399B34C3.dita"><apiname>CApaSystemControlList</apiname></xref> class provides a list of all
-the available control panel applications present on the device. </p> <codeblock id="GUID-1D32560F-C5B9-5198-BB05-259CC8BCEE6A" xml:space="preserve">
-// Create a file server session by creating an RFs object.
-
-RFs fs;
-fs.Connect();
-CApaSystemControlList* cControlList;
-
-TRAP(ret,cControlList=CApaSystemControlList::NewL(fs));
-if( ret==KErrNone )
-    {
-     //success scenario , implementation...
-    }</codeblock> </li>
-<li id="GUID-CDC1A815-8E88-5DE1-92CE-50A6F5CF660F"><p>Also in the application's
-source code, create a control panel application in either of the following
-ways: </p> <p>  </p><codeblock id="GUID-E842DF15-BA2B-5EDB-A624-1830C69C5557" xml:space="preserve">// <b>Using UID</b>
-const TInt KsimpleAppUidValue = 0x23256ADE;
-
-// Create the control panel application in the list using the specified UID
-
-CApaSystemControl* Control = cControlList-&gt;Control(TUid(KsimpleAppUidValue));
-</codeblock> <p>  </p> <codeblock id="GUID-4F497DF1-569A-5F8E-BCA3-705F0D846CA8" xml:space="preserve">//<b>Using Index</b>
-// Create a control panel application using the index ID
-TInt indexID = 2;
-
-CApaSystemControl* control=cControlList-&gt;Control(indexID);
-</codeblock> </li>
-</ol> </section>
-</conbody><related-links>
-<link href="GUID-940F3F6E-BA9C-5E19-9AC5-D848B5E175FB.dita"><linktext>Application
-Architecture Overview</linktext></link>
-<link href="GUID-617A7B7E-DF91-5757-B473-D2E0B665F5E4.dita"><linktext>Application
-resource tools guide</linktext></link>
+<?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-86AB2626-27F1-5761-85F7-5644C5D0A675" xml:lang="en"><title>Creating a Control Panel Application</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-09ECA3CE-5009-4E2B-AE78-2F6FCE9AEF1F"><title>Introduction</title> <p>A control panel application
+is used to modify system settings. To create a control panel application
+a registration resource file is required which contains information
+about the application UID and the name of the application’s executable. </p> <p> <b>Note</b>: You need to create the registration resource file
+and specify its source and destination path in the <filepath>mmp</filepath> file. </p> </section>
+<section id="GUID-99F3B350-EE89-49D2-8A7F-F39215B5706A"><title>Procedure</title> <p>The following procedure describes
+how to prepare the registration resource file and create a control
+panel application: </p> <ol id="GUID-70B60865-FC75-5A84-9FF2-F826481065AA">
+<li id="GUID-5CDEA94D-5B9A-5A93-9012-EC5DAD6A3BCE"><p>Define the attributes
+of the control panel application in the registration resource file. </p> <p>The attributes of the <codeph>APP_REGISTRATION_INFO</codeph> resource
+must have the <codeph>KAppIsControlPanelItem</codeph> attribute as
+shown in the code snippet: </p> <codeblock id="GUID-BF23DB83-177D-5165-87C3-E7D167E1A238" xml:space="preserve">#include &lt;appinfo.rh&gt;
+UID2 KUidAppRegistrationResourceFile
+UID3 0x23256ADE
+RESOURCE APP_REGISTRATION_INFO
+    {    
+    app_file = app_CTRL2;
+    attributes=KAppIsControlPanelItem;
+    }</codeblock> </li>
+<li id="GUID-B097566C-1F40-5218-9CCD-13D882CB646F"><p>In the source
+code of the application, create an instance of the <xref href="GUID-4FB064FC-210C-384A-BE92-35CA399B34C3.dita"><apiname>CApaSystemControlList</apiname></xref> class using the <xref href="GUID-4FB064FC-210C-384A-BE92-35CA399B34C3.dita#GUID-4FB064FC-210C-384A-BE92-35CA399B34C3/GUID-68F9CFBD-C7FE-3AAE-92E1-DA4677D50D31"><apiname>CApaSystemControlList::NewL()</apiname></xref> function to create and initialize a control panel application list
+as shown in the code snippet. The <xref href="GUID-4FB064FC-210C-384A-BE92-35CA399B34C3.dita"><apiname>CApaSystemControlList</apiname></xref> class provides a list of all the available control panel applications
+present on the device. </p> <codeblock id="GUID-1D32560F-C5B9-5198-BB05-259CC8BCEE6A" xml:space="preserve">
+// Create a file server session by creating an RFs object.
+
+RFs fs;
+fs.Connect();
+CApaSystemControlList* cControlList;
+
+TRAP(ret,cControlList=CApaSystemControlList::NewL(fs));
+if( ret==KErrNone )
+    {
+     //success scenario , implementation...
+    }</codeblock> </li>
+<li id="GUID-CDC1A815-8E88-5DE1-92CE-50A6F5CF660F"><p>Also in the
+application's source code, create a control panel application in either
+of the following ways: </p> <p>  </p><codeblock id="GUID-E842DF15-BA2B-5EDB-A624-1830C69C5557" xml:space="preserve">// <b>Using UID</b>
+const TInt KsimpleAppUidValue = 0x23256ADE;
+
+// Create the control panel application in the list using the specified UID
+
+CApaSystemControl* Control = cControlList-&gt;Control(TUid(KsimpleAppUidValue));
+</codeblock> <p>  </p> <codeblock id="GUID-4F497DF1-569A-5F8E-BCA3-705F0D846CA8" xml:space="preserve">//<b>Using Index</b>
+// Create a control panel application using the index ID
+TInt indexID = 2;
+
+CApaSystemControl* control=cControlList-&gt;Control(indexID);
+</codeblock> </li>
+</ol> </section>
+</conbody><related-links>
+<link href="GUID-940F3F6E-BA9C-5E19-9AC5-D848B5E175FB.dita"><linktext>Application
+Architecture Overview</linktext></link>
 </related-links></concept>
\ No newline at end of file