<?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 task

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

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

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

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

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

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

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

the application exits. </p><ul>

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

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

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

default view.</p></li>

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

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

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

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

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

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

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

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

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

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