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 task

    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

    12 <task id="GUID-210A181E-5EB6-4626-9E7E-8761A2272D79" xml:lang="en"><title>Set

    13 a view as a default view</title><prolog><metadata><keywords/></metadata></prolog><taskbody>

    14 <context>       <p>An application can set a specific registered view as the

    15 default view. The default view is displayed when the application is launched

    16 or brought to the foreground. Also, a system default view can be set, which

    17 is used when an unrecoverable error occurs during view activation or when

    18 the application exits. </p><ul>

    19 <li><p>Application default view </p><codeblock xml:space="preserve">CCoeAppUi::SetDefaultViewL( MCoeView&amp; aView )</codeblock><p>Sets

    20 the specified view as the default view for the application. If the application

    21 already has the default view set, then the specified view overrides existing

    22 default view.</p></li>

    23 <li><p>System default view.</p><ul>

    24 <li><codeblock xml:space="preserve">CCoeAppUi::SetSystemDefaultViewL( const TVwsViewId &amp; )</codeblock><p>Sets

    25 the system default view for default screen device mode, which is <codeph>0</codeph>.</p></li>

    26 <li><codeblock xml:space="preserve">CCoeAppUi::SetSystemDefaultViewL( const TVwsViewId &amp;,TInt )</codeblock><p>Sets

    27 the specified view as system default view for a given screen mode.</p></li>

    28 </ul><note> An application must have the <codeph>ECapabilityWriteDeviceData</codeph> capability

    29 to set a view as a system default view. If the system default view is already

    30 set, then the specified view overrides existing default view.  </note></li>

    31 </ul><p> The following code snippet shows setting a view as the default view

    32 for an application:</p><codeblock xml:space="preserve">iCCoeAppUi-&gt;SetDefaultViewL( iViewId );</codeblock></context>

    33 </taskbody></task>