<?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 reference

  PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

<reference id="GUID-F64B88E0-49DA-5563-896E-29BAB8A244C9" xml:lang="en"><title>HelloWorld:

A simple GUI application with a single view</title><shortdesc>This example demonstrates a simple application using a GUI with

a single view. </shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody>

<section><title>Download</title> <p>Click on the following link to download

the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-a2004cb9-da88-4ec7-a85e-dd648022f4f9.zip" scope="external">HelloWorldGUI.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-a2004cb9-da88-4ec7-a85e-dd648022f4f9.html" scope="peer">browse</xref> to view the example code. </p> </section>

<section><title>Class Summary</title><p><xref href="GUID-E36E2F07-09E7-32BC-BB83-14DF9232E7D9.dita"><apiname>CEikApplication</apiname></xref></p><p><xref href="GUID-B33A8A56-D1BE-3E3D-B5AC-F644A5C764DB.dita"><apiname>CEikDocument</apiname></xref></p><p><xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita"><apiname>CEikAppUi</apiname></xref></p><p><xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref></p></section>

<section><title>Design and implementation</title> <p>This application consists

of 4 classes: </p> <ul>

<li id="GUID-28A83A4A-D743-556B-88EB-D65AAFD29D19"><p>Application class derived

from <xref href="GUID-E36E2F07-09E7-32BC-BB83-14DF9232E7D9.dita"><apiname>CEikApplication</apiname></xref>. </p> </li>

<li id="GUID-EF3F2195-1D04-56A4-B439-C2B50F543F74"><p>Document class derived

from <xref href="GUID-B33A8A56-D1BE-3E3D-B5AC-F644A5C764DB.dita"><apiname>CEikDocument</apiname></xref>. </p> </li>

<li id="GUID-65ABFCB1-BC5A-5BCA-9F45-D5FF82AB1AE4"><p>AppUi class derived

from <xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita"><apiname>CEikAppUi</apiname></xref>. </p> </li>

<li id="GUID-12BE51BC-0F68-5C5E-A279-4AE00E96FC7D"><p>AppView class derived

from <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>. </p> </li>

</ul> <p> <codeph>E32Main()</codeph> marks the entry point to the example.

It calls <codeph>EikStart::RunApplication()</codeph> to create a new application

instance. The UI framework then calls <codeph>CExampleApplication::AppDllUid()</codeph> to

obtain the application's UID. The UID returned must match the second value

defined in the project definition file. </p> <p>Once the application is created,

the UI framework calls <codeph>CExampleApplication::CreateDocumentL()</codeph> to

create an instance of the document class. <codeph>CreateDocumentL()</codeph> internally

calls the constructor of the document class and passes the supplied reference

to the constructor initialisation list. The document has no real work to do

in this simple GUI application. </p> <p>As soon as the document has been created

the UI framework creates an instance of the application UI (appUI). The appUI

class is an instance of a <xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita"><apiname>CEikAppUi</apiname></xref> -derived class and

this class takes care of user interaction. </p> <p>AppUI creation uses two

phase construction where first <codeph>CExampleDocument::CreateAppUiL()</codeph> is

called and then the framework calls the second phase constructor of the appUI

class. <codeph>CExampleAppUi::ConstructL()</codeph> creates and owns the view.

User commands are handled by the <codeph>CExampleAppUi::HandleCommandL()</codeph> method. </p> <p>The

app view class is used to draw the view. The view in this example consists

of a simple outline rectangle with text drawn in the middle. </p> <p>The example

contains a resource file <filepath>HelloWorld.rss</filepath> which defines

resource information. This includes a menubar with four menu items, an icon

and caption. </p> <p> <filepath>HelloWorld.hrh</filepath> defines the menu

command IDs and <filepath>HelloWorld.pkg</filepath> file is the source file

used for installation file (SIS file) generation. </p> </section>

<section><title>Building and configuring</title> <p>Steps to build the example: </p> <ul>

<li id="GUID-81019373-E4C4-545E-85B9-1C4810203D5D"><p>You can build the example

from your IDE or the command line. </p> <p>If you use an IDE, import the <filepath>bld.inf</filepath> file

of the example into your IDE, and use the build command of the IDE. </p> <p>If

you use the command line, open a command prompt, and set the current directory

to the source code directory of the example. You can then build the example

with the SBSv1 build tools with the following commands: </p> <p><userinput>bldmake

bldfiles</userinput> </p> <p><userinput>abld build</userinput> </p> <p><xref href="GUID-793A5EF9-CC16-5EEB-9011-6431EA76EB15.dita">How to use bldmake</xref> and <xref href="GUID-B6B54E07-3B34-5D5C-8815-93383FA8FB4B.dita">How to use abld</xref> describe

how to use the SBSv1 build tools. </p> </li>

<li id="GUID-83E08D73-33DB-520B-8606-6547796EDE28"><p>For the emulator, the

example builds an executable called <filepath>helloworld.exe</filepath> in

the <filepath>epoc32\release\winscw\&lt;udeb or urel&gt;\</filepath> folder. </p> </li>

</ul> </section>

</refbody></reference>