<?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->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->Control(indexID);

</codeblock> </li>

</ol> </section>

</conbody><related-links>

<link href="GUID-940F3F6E-BA9C-5E19-9AC5-D848B5E175FB.dita"><linktext>Application

Architecture Overview</linktext></link>