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-6167C2F2-BC5B-5B10-BD5D-7702BE4112F6" xml:lang="en"><title>View

    13 Server Tutorial</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>The UI Control Framework <xref href="GUID-6C16417B-5B37-5310-B59A-750D971AA6D4-GENID-1-8-1-3-1-1-7-1.dita">(CONE)</xref> provides <xref href="GUID-3AC2CDAC-0291-309F-A020-049BC9F2CF90.dita"><apiname>CCoeAppUi</apiname></xref> that

    15 provides an interface to the View Server, which enables seamless switching

    16 between different views across various applications. </p>

    17 

    18 <section><title>Introduction</title> <p>The UI framework built on Cone/uikon

    19 can make a choice to use the View Server. </p> <p>The view architecture allows

    20 applications to make and receive requests to show a particular view of their

    21 data. It allows applications to have integration between their user interfaces.

    22 This particularly allows the user to navigate through the UI on the basis

    23 of the task they are working on, rather than perceiving separate applications.

    24 For example, an application provides a view of a given Contact, any other

    25 application may display a contact using that view. </p> <p>Views are UI controls

    26 that are derived from the <xref href="GUID-2C5E3F6C-6679-3914-9736-62296E7715A7.dita"><apiname>MCoeView</apiname></xref> abstract view interface

    27 and display application data. Typically views are top-level window-owning

    28 controls. Each view is given a unique identifier of type <xref href="GUID-3DEA9A17-CB50-3DCD-87AC-0E91B377FB0E.dita"><apiname>TVwsViewId</apiname></xref>. <xref href="GUID-3DEA9A17-CB50-3DCD-87AC-0E91B377FB0E.dita"><apiname>TVwsViewId</apiname></xref> is

    29 a combination of the UID of the application and the UID of the view within

    30 the application. An application participating in the view switching must complete

    31 the steps given in the procedure section.</p> </section>

    32 <section><title>Procedure</title> <ol id="GUID-5DC514F9-9040-5D61-BC2C-FE04BA11B51C">

    33 <li id="GUID-1696E5F0-DB4A-5F40-B6E8-810FA93DC5A5"><p><xref href="GUID-AC6FCBB0-E4FD-4D30-B000-1F652B2EE96A.dita">Create

    34 an instance of <apiname>CCoeAppUi</apiname></xref> </p> </li>

    35 <li id="GUID-441C5876-D063-568F-A814-B85464DBCE27"><p><xref href="GUID-13D2B45C-3A2A-497A-8D6A-87BE34D1DE69.dita">Implement

    36 the observer functions to get notification on events, if required.</xref> </p> </li>

    37 <li id="GUID-32128AF4-8773-5105-B5C0-490668AB08C4"><p><xref href="GUID-A399508A-DE6A-490D-9BFB-4FCF56FF9D4C.dita">Derive

    38 a class from the <apiname>MCoeView</apiname> class.</xref> </p> </li>

    39 <li id="GUID-C95EBECB-3503-5BB6-B0CC-8964C76074A8"><p><xref href="GUID-6FD4E7A4-D215-4CFB-BC7A-23065DE95C5C.dita">Add

    40 the view to the control stack to receive key events.</xref> </p> </li>

    41 <li id="GUID-9996BF57-3220-5D74-B7A1-5CD56D63F905"><p><xref href="GUID-940E3C48-D0ED-419A-9172-E4856C6CA809.dita">Register

    42 the view with the View Server. </xref></p> </li>

    43 <li id="GUID-C571AF24-46FA-517C-A765-1745973FE8DF"><p>Perform one or more

    44 of the following tasks: </p> <ol id="GUID-A24F5604-C2CF-52DF-BDD4-BF4FDB36325B">

    45 <li id="GUID-63CFD000-82CB-5842-9AF4-05FA34C0E24C"><p><xref href="GUID-2D6689C2-F17D-48A8-8EC9-3D83BCAA3681.dita">Activate

    46 a view through the client session.</xref> </p> <p>If the view which has to

    47 be activated is not registered with the server when an activation request

    48 arrives, the view server starts the application associated with that view. </p> </li>

    49 <li id="GUID-18668608-892D-57CF-9619-B5D141E5AA37"><p><xref href="GUID-210A181E-5EB6-4626-9E7E-8761A2272D79.dita">Set

    50 a view as a default view.</xref> </p> </li>

    51 <li id="GUID-6A1FBF71-8F52-58C2-AEFA-FC4ED601CDD1"><p><xref href="GUID-4ADDDAFE-0941-4787-B07B-F5B7D8D5B1AA.dita">Deregister

    52 a view</xref>, if required. </p> </li>

    53 </ol> </li>

    54 </ol> </section>

    55 </conbody><related-links>

    56 <link href="GUID-830E40D0-7DEE-5EFB-BCC6-EC0AA7FF7A02.dita"><linktext>View Server

    57 Overview</linktext></link>

    58 <link href="GUID-37E8A48E-09B8-5958-9263-B33EDAE3F7C6-GENID-1-8-1-3-1-1-7-1-3-1.dita"><linktext>Control Stack</linktext>

    59 </link>

    60 </related-links></concept>