<?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 xml:lang="en" id="GUID-1C802DBD-1453-5C69-94D5-FB0229C544D6"><title>Uikon Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody><section><title>Purpose</title> <p>Provides the top-layer of the framework for applications. The framework is fundamental to all GUI applications.</p> </section> <section><title>Architectural relationships</title> <p>Uikon provides a UI library layer that is common to all Symbian OS phones. UI variants add further UI libraries that can include controls that derive from the ones provided by Uikon. Application developers can use the Uikon APIs directly, though they should check that there is not a more appropriate phone-specific API available in the UI variant's own libraries. </p> <p>The Uikon application framework extends two lower frameworks:</p> <ul><li id="GUID-6941969D-7625-5376-A5D6-5E5B0378D0E7"><p>the Application Architecture Framework: handles application start-up and accessing the application data (its <i>document</i>). </p> </li> <li id="GUID-F1AA0F97-5205-537C-994A-6A3FA811AA72"><p>UI Control Framework: provides the framework for drawing and handling input to screen controls</p> </li> </ul> <p> Uikon ties these two frameworks together to provide the framework for the standard application design. </p> <p>Uikon's framework classes are extended in turn by:</p> <ul><li id="GUID-EF33F5C8-6EA8-5D8A-AE53-A35C692E291A"><p>applications, to implement appropriate behaviour for their type of data, and for their types of command</p> </li> <li id="GUID-66353589-7D6B-548E-81A0-3A3515CF8BD8"><p>possibly by UI variant-specific libraries, to add UI variant-specific behaviour to the application framework</p> </li> </ul> </section> <section><title>Description</title> <p>The API has five key concepts: application (<codeph>CEikApplication</codeph>), document (<codeph>CEikDocument</codeph>), app UI (<codeph>CEikAppUi</codeph>), UI Environment (<codeph>CEikonEnv</codeph>), and utilities (<codeph>EikFileUtils</codeph>).</p> <p><b>Application</b> </p> <p>The application class defines properties of the application, such as UID and caption, and creates a new document.</p> <p>The application base class is provided by <xref href="GUID-E36E2F07-09E7-32BC-BB83-14DF9232E7D9.dita"><apiname>CEikApplication</apiname></xref>.</p> <p><b>Document</b> </p> <p>The document class represents the data model for the application. In file-based applications, it stores and restores the application's data. It handles requests to edit a document by creating an app UI.</p> <p>The document base class is provided by <xref href="GUID-B33A8A56-D1BE-3E3D-B5AC-F644A5C764DB.dita"><apiname>CEikDocument</apiname></xref>.</p> <p><b>App UI</b> </p> <p>The app UI is the central user interface class. It creates and owns controls to display the application data, and centralises handling of command input from standard controls such as menus and toolbars.</p> <p>The app UI base class is provided by <xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita"><apiname>CEikAppUi</apiname></xref>, which can be customised by using the resource structure <xref href="GUID-77DF8122-9267-36A6-B5C5-AC989828F2EA.dita"><apiname>EIK_APP_INFO</apiname></xref>.</p> <p><b>UI Environment</b> </p> <p>The UI Environment provides a large number of assorted UI functionality, particularly simple access to information and query dialogs, and access to standard system UI resources (bitmaps and fonts). Every object in a GUI application can access a UI Environment (through <xref href="GUID-96CA3B4B-993F-36C0-9A5B-DF5CC74EE20E.dita#GUID-96CA3B4B-993F-36C0-9A5B-DF5CC74EE20E/GUID-3587E866-F434-30BA-9CFC-0D40EF8D47FE"><apiname>CEikonEnv::Static()</apiname></xref>), as a pointer to it is stored in thread-local storage.</p> <p>The UI Environment is provided by <xref href="GUID-96CA3B4B-993F-36C0-9A5B-DF5CC74EE20E.dita"><apiname>CEikonEnv</apiname></xref>.</p> <p><b>Utilities</b> </p> <p>Utility classes provide easy access for applications to frequently-used functionality. Notable are <xref href="GUID-EF4568CF-947B-3931-B860-2A63A6B7C275.dita"><apiname>EikFileUtils</apiname></xref> for file access, and <xref href="GUID-C886511D-1922-3703-843D-1936018788AC.dita"><apiname>EikResourceUtils</apiname></xref> for resource access.</p> </section> <section><title>See also</title> <p><xref href="GUID-37E8A48E-09B8-5958-9263-B33EDAE3F7C6.dita">UI Control Framework Overview</xref> </p> </section> </conbody></concept>