|
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& 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 & )</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 &,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->SetDefaultViewL( iViewId );</codeblock></context> |
|
33 </taskbody></task> |