|
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-B5DE1C86-2B16-4B22-887F-7079E54A8ED6" xml:lang="en"><title>Traditional |
|
13 Symbian UI application architecture</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>The following image illustrates the components of the traditional architecture |
|
15 approach.</p> |
|
16 <fig id="GUID-F38DBC9C-31C0-4E4F-934C-38BA4A4B649F"><title>Traditional Symbian UI application architecture classes</title><image href="GUID-DA2C605B-6CCF-4039-BD02-DD4BDA003C97_d0e47056_href.png"/></fig> |
|
17 <p>Symbian platform applications that follow the traditional Symbian UI |
|
18 application architecture require:</p> |
|
19 <ul> |
|
20 <li><p>a <xref href="GUID-FD2CDEB8-0784-4BE5-A775-170F57D71BBC.dita">UI |
|
21 controller</xref> derived from <xref href="GUID-77329067-34D9-3698-B764-294535E660EB.dita"><apiname>CAknAppUi</apiname></xref>.</p></li> |
|
22 <li><p>a <xref href="GUID-DAC32BB9-C0EB-42FF-A596-C2F1A90A4BD7.dita">view</xref> or |
|
23 views derived from <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>.</p></li> |
|
24 </ul> |
|
25 <p>The traditional Symbian UI application architecture provides the most |
|
26 flexible approach to application UI construction. Traditional architecture |
|
27 is easier to port across different platforms than <xref href="GUID-68B999C2-0993-4804-9624-42C3D88BE5C7.dita">view |
|
28 architecture</xref>. Traditional architecture is also the best choice for |
|
29 single-view applications, if launching the view from external applications |
|
30 is not required.</p> |
|
31 <p>Typical responsibilities in this architecture are:</p> |
|
32 <ul> |
|
33 <li><p><xref href="GUID-77329067-34D9-3698-B764-294535E660EB.dita"><apiname>CAknAppUi</apiname></xref>-derived class acts as a UI controller:</p> |
|
34 <ul> |
|
35 <li><p>It <xref href="GUID-A29FB4CA-2161-4407-BA69-48FBF5D7543F.dita">creates</xref> one |
|
36 or more <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>-derived views.</p></li> |
|
37 <li><p>It handles <xref href="GUID-EF7FF39E-929F-4767-B475-5D582D37BB32.dita">events</xref>, |
|
38 including enabling views to handle <xref href="GUID-E402616A-7ED8-45AC-B836-99C3A3760B33.dita">key |
|
39 events</xref>.</p></li> |
|
40 <li><p>To <xref href="GUID-FC63E2D1-697C-4890-9B70-0DC0AAE7597C.dita">switch |
|
41 between views</xref>, it creates and destroys or shows and hides views.</p> |
|
42 </li> |
|
43 <li><p>It handles menu <xref href="GUID-4941C035-C359-4968-9BD5-31F44EE5F810.dita">commands</xref>.</p> |
|
44 </li> |
|
45 <li><p>It receives events such as <xref href="GUID-DD15F24B-0786-4531-A6C5-A5E70EBE2732.dita">layout</xref> and <xref href="GUID-3B441CDC-AB7A-4D8D-A595-57C21E1D426C.dita">foreground</xref> notifications |
|
46 from the run-time environment.</p></li> |
|
47 </ul> |
|
48 </li> |
|
49 </ul> |
|
50 <ul> |
|
51 <li><p><xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>-derived view:</p> |
|
52 <ul> |
|
53 <li><p>Shows application data and state on the screen.</p></li> |
|
54 <li><p>Receives user input.</p></li> |
|
55 <li><p>Notifies the <xref href="GUID-77329067-34D9-3698-B764-294535E660EB.dita"><apiname>CAknAppUi</apiname></xref>-derived class of |
|
56 relevant events.</p></li> |
|
57 <li><p>Often observes model changes (directly or via the UI controller) |
|
58 and updates the screen accordingly.</p></li> |
|
59 </ul> |
|
60 </li> |
|
61 </ul> |
|
62 <p>For more information on the <xref href="GUID-4F825D83-47A4-36C9-9A25-943A6D799F84.dita"><apiname>CAknApplication</apiname></xref> and <xref href="GUID-935C59EE-AD66-33FE-987B-BD97F5147CC1.dita"><apiname>CAknDocument</apiname></xref>-derived |
|
63 classes, see <xref href="GUID-BDDDF68F-F7C3-43AF-8B6C-C77C701FD2A9.dita">Framework |
|
64 requirements for GUI applications</xref>.</p> |
|
65 </conbody></concept> |