2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
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 |
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, |
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". --> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
6 <!-- Initial Contributors: |
6 <!-- Initial Contributors: |
7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-B02C762B-C452-4184-ABEA-4753E6CD47D2" xml:lang="en"><title>Scalability</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-B02C762B-C452-4184-ABEA-4753E6CD47D2" xml:lang="en"><title>Scalability</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
10 <p>The term <i>scalability</i> refers to the ability of an application |
13 <p>The term <i>scalability</i> refers to the ability of an application |
11 UI to function as designed in mobile devices with different screen resolutions |
14 UI to function as designed in mobile devices with different screen resolutions |
12 or orientations. For example, in the figure below, the UI scales to fit both |
15 or orientations. For example, in the figure below, the UI scales to fit both |
13 portrait and landscape orientations.</p> |
16 portrait and landscape orientations.</p> |
14 <fig id="GUID-573B32DC-5C53-47B2-8239-AA038E945E81"><title>Scaling</title><image href="GUID-5F9E2762-855A-4DE6-A11B-A5F0D51E19D9_d0e67243_href.png"></image></fig> |
17 <fig id="GUID-D889D539-AD96-4E67-A52A-EC14FF98E299"><title>Scaling</title><image href="GUID-A69D2707-CB47-42C2-A6E9-5FB9BD86A30B_d0e73770_href.png"/></fig> |
15 <p>When you enable scaling in your application, you allow your application |
18 <p>When you enable scaling in your application, you allow your application |
16 to support the different display sizes, resolutions, and layouts for different |
19 to support the different display sizes, resolutions, and layouts for different |
17 devices based on the Symbian platform. The Symbian platform provides APIs |
20 devices based on the Symbian platform. The Symbian platform provides APIs |
18 and other support to enable scaling in applications. Some scaling issues are |
21 and other support to enable scaling in applications. Some scaling issues are |
19 handled by the application framework if support is enabled, while other issues |
22 handled by the application framework if support is enabled, while other issues |
26 <p>The following issues should be kept in mind when enabling your application |
29 <p>The following issues should be kept in mind when enabling your application |
27 for scaling:</p> |
30 for scaling:</p> |
28 <ul> |
31 <ul> |
29 <li><p>Layout information should not be hard-coded.</p> |
32 <li><p>Layout information should not be hard-coded.</p> |
30 <itemgroup> |
33 <itemgroup> |
31 <p> The Symbian platform provides the <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classAknLayoutUtils.html" format="application/java-archive"><parmname>AknLayoutUtils</parmname></xref> class |
34 <p> The Symbian platform provides the <parmname>AknLayoutUtils</parmname> class |
32 for building layouts from resource files.</p> |
35 for building layouts from resource files.</p> |
33 <p>Note that you also need to <xref href="GUID-DD15F24B-0786-4531-A6C5-A5E70EBE2732.dita">override <parmname>CCoeControl::HandleResourceChange</parmname> and <parmname>CEikAppUi::HandleResourceChangeL</parmname></xref> in your |
36 <p>Note that you also need to <xref href="GUID-DD15F24B-0786-4531-A6C5-A5E70EBE2732.dita">override <parmname>CCoeControl::HandleResourceChange()</parmname> and <parmname>CEikAppUi::HandleResourceChangeL()</parmname></xref> in your |
34 application to draw your application again in the event that the orientation |
37 application to draw your application again in the event that the orientation |
35 of the display changes.</p> |
38 of the display changes.</p> |
36 </itemgroup> |
39 </itemgroup> |
37 </li> |
40 </li> |
38 <li><p>Scalable fonts should be used.</p> |
41 <li><p>Scalable fonts should be used.</p> |
39 <itemgroup> |
42 <itemgroup> |
40 <p>The Symbian platform provides methods in the <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classAknLayoutUtils.html" format="application/java-archive"><parmname>AknLayoutUtils</parmname></xref> for |
43 <p>The Symbian platform provides methods in the <parmname>AknLayoutUtils</parmname> for |
41 using logical fonts from an enumeration in the avkon.hrh file.</p> |
44 using logical fonts from an enumeration in the <parmname>avkon.hrh</parmname> file.</p> |
42 </itemgroup> |
45 </itemgroup> |
43 </li> |
46 </li> |
44 <li><p>Scalable icons should be used.</p> |
47 <li><p>Scalable icons should be used.</p> |
45 <itemgroup> |
48 <itemgroup> |
46 <p>Scalable icons are based on SVG Tiny (SVG-T) format <xref href="GUID-D76B1001-BAF5-4557-A07E-61065523ECBE.dita">graphics</xref>.</p> |
49 <p>Scalable icons are based on SVG Tiny (SVG-T) format <xref href="GUID-D76B1001-BAF5-4557-A07E-61065523ECBE.dita">graphics</xref>.</p> |