Symbian3/PDK/Source/GUID-1E87CA7A-9733-58A1-A747-F5F3DE9B64D7.dita
changeset 9 59758314f811
child 12 80ef3a206772
equal deleted inserted replaced
8:ae94777fff8f 9:59758314f811
       
     1 <?xml version="1.0" encoding="utf-8"?>
       
     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
       
     3 <!-- This component and the accompanying materials are made available under the terms of the License 
       
     4 "Eclipse Public License v1.0" which accompanies this distribution, 
       
     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
       
     6 <!-- Initial Contributors:
       
     7     Nokia Corporation - initial contribution.
       
     8 Contributors: 
       
     9 -->
       
    10 <!DOCTYPE concept
       
    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
       
    12 <concept id="GUID-1E87CA7A-9733-58A1-A747-F5F3DE9B64D7" xml:lang="en"><title>ControlFramework: A UI application with a toolbar</title><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    13 <section id="GUID-F8C6B617-BD51-4A79-9B8E-74C453343045"><title>Description</title> <p>This example program creates an application that uses a single
       
    14 view. It implements the standard classes required by any application
       
    15 using UI controls. That is, an application, a document, an application
       
    16 UI and a view. </p> <p>A view is a control (derived from <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>) that displays the application's data on the
       
    17 screen and handles user input. The pointer and key input is handled
       
    18 by printing to the screen a description of the key event, or the x,y
       
    19 coordinates of the pointer event. </p> <p>The application and document
       
    20 are implemented minimally. The application UI handles commands by
       
    21 overriding the <xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita#GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E/GUID-D6E5C363-CF39-3E56-B717-57CCEE8DC96F"><apiname>CEikAppUi::HandleCommandL()</apiname></xref> method.
       
    22 In this example, commands are generated by the toolbar buttons, and
       
    23 are handled by changing the formatting of the text. The text that
       
    24 is initially displayed is read from a resource file. </p> </section>
       
    25 <section id="GUID-5CA06077-7F63-4E48-85A5-B4D92D8D4A7A"><title>Download</title> <p>Click on the following link to download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-10dbd09f-5242-44c4-b3f3-b62669bd8c53.zip" scope="external">ControlFramework.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-10dbd09f-5242-44c4-b3f3-b62669bd8c53.html" scope="peer">browse</xref> to view the example code. </p> </section>
       
    26 <section id="GUID-EE3123AF-180A-48AC-99E5-BE75DF5847B8"><title>Class
       
    27 Summary</title><ul>
       
    28 <li><p><xref href="GUID-E36E2F07-09E7-32BC-BB83-14DF9232E7D9.dita"><apiname>CEikApplication</apiname></xref></p></li>
       
    29 <li><p><xref href="GUID-B33A8A56-D1BE-3E3D-B5AC-F644A5C764DB.dita"><apiname>CEikDocument</apiname></xref></p></li>
       
    30 <li><p><xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita"><apiname>CEikAppUi</apiname></xref></p></li>
       
    31 <li><p><xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref></p></li>
       
    32 </ul></section>
       
    33 <section id="GUID-E6DD4EA2-7F4A-4C87-AEC5-3F06AC2D0F2D"><title>Build</title> <p>The <xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">Symbian
       
    34 build process</xref> describes how to build an application. </p> <p>The ControlFramework example builds an executable called <filepath>ControlFramework.exe</filepath> in the standard location (<filepath>\epoc32\release\winscw\</filepath> <i>&lt;build_variant&gt;</i> for
       
    35 CodeWarrior). Either launch the executable itself, or launch the emulator
       
    36 and then select the ControlFramework application from the Emulator's
       
    37 extras bar. </p> </section>
       
    38 <section id="GUID-7C8D5BAF-0D50-4778-82C3-F5AFCBBA165B"><title>See
       
    39 also</title> <p> <xref href="GUID-6C16417B-5B37-5310-B59A-750D971AA6D4.dita">Using UI Control Framework (CONE)</xref>  </p> </section>
       
    40 </conbody></concept>