<?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 id="GUID-CCFF2755-02EC-510B-A052-33ABA318B922" xml:lang="en"><title>Examples

of use</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>Text objects can be used for a variety of purposes. Some examples throughout

the Symbian platform and its standard applications include:</p>

<ul>

<li id="GUID-0FAFB638-FB94-5955-A879-B6297F4BA542"><p>word processor documents</p> <p>A

word processor document is a single rich text object, containing fields, pictures

and styles. This is the "classic" use of text content and views.</p> </li>

<li id="GUID-2E076BB5-0501-55AA-BA18-6454D7DF1D83"><p>spreadsheet cells</p> <p>A

spreadsheet contains a number of global text cells, each of which shares a

common paragraph and character format layer. This enables the text to be maintained

by text content and displayed using text views, but avoids duplicating format

layers.</p> </li>

<li id="GUID-EF8987E4-DE93-5531-867F-2318E696522A"><p>editor controls</p> <p>Editors

for rich and global text provide the functionality needed for editing text

objects, descriptors, and even text representations of floating point numbers

etc.</p> </li>

<li id="GUID-9B48DACD-A393-5796-9BE3-DD25812559AB"><p>agenda views</p> <p>The

complex requirements of the day view in the agenda application are met by

putting all text into a single rich text object, with appropriate formatting.

This allows the powerful facilities of text views to format the display neatly,

including such facilities as slot squashing, rounded highlights on bullets

etc.</p> <p>When an individual entry is edited, its own data is edited in

a separate rich text object. This is later pasted back into the view.</p> </li>

<li id="GUID-4A0E4173-7F13-56E2-BE4A-1E0DEC5715C6"><p>things which can contain

embedded objects</p> <p>Since rich text contains pictures, and rich text editors

allow these to be edited, any application can contain pictures in its data,

and can therefore embed objects, simply by using rich text to store its entry

data. Both the agenda and the database may contain rich text objects, which

allows their entries to contain pictures.</p> </li>

</ul>

<p>It is very easy to use rich text in an application. The system provides

enough flexibility to be tailored for specialist applications, such as the

spreadsheets stringent memory economy, or the agenda's complex views.</p>

<p>In the absence of an application engine, typically, two prerequisites for

the editing and layout of rich or global text are a text layout and a view.

The <xref href="GUID-CF377A98-F11F-380F-AD10-7F3E261D4421.dita"><apiname>CTextView</apiname></xref> and <xref href="GUID-FEE7C848-2E93-3848-A3DA-7EAA533615AF.dita"><apiname>CTextLayout</apiname></xref> classes

provide the engine for handling changes to formatting and content and for

drawing and updating the <keyword>text view</keyword>. They are optimised

for efficiency. </p>