--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-2D6689C2-F17D-48A8-8EC9-3D83BCAA3681.dita Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,36 @@
+<?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-2D6689C2-F17D-48A8-8EC9-3D83BCAA3681" xml:lang="en"><title>Activate
+a view</title><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<context> <p>Activation is the process of switching or linking to a
+view. When the new view is activated, the old view is deactivated, and the
+new view is marked as the current view. Applications can have only a single
+view active at any given point of time. The current active view is the view
+that interacts with the user and receives events and menu choices.</p>
+ <p>Activation of a view is done using any of the following methods: </p><ul>
+<li><p>View activation without custom message. </p><codeblock xml:space="preserve">CCoeAppUi::ActivateViewL( TVwsViewId& aViewId )
+</codeblock></li>
+<li><p>View activation with custom message.</p><codeblock xml:space="preserve">CCoeAppUi::ActivateViewL( TVwsViewId& aViewId TUid aCustomMessageId,
+ TDesC8& CustomMessage )</codeblock></li>
+</ul><note> Deactivation of view is necessary before exiting from the application,
+if the application UI has an active view. This can be done using the <codeph>CCoeAppUi::DeactivateActiveViewL(
+)</codeph> function.</note><p>The following code snippet shows activating
+a view:</p><codeblock xml:space="preserve">void CNewAppUi::ActivateViewL(const TVwsViewId& aViewId,TUid aCustomMessageId,const TDesC16& aCustomMessage)
+ {
+ HBufC8* narrowMessage = HBufC8::NewLC( aCustomMessage.Size() );
+ TPtr8 ptr=narrowMessage->Des();
+ ptr.Copy( ( TUint8* )aCustomMessage.Ptr(), aCustomMessage.Size() );
+ CCoeAppUi::ActivateViewL( aViewId,aCustomMessageId,narrowMessage->Des() );
+ iCCoeAppUi->NotifyNextActivation( *iViewActivationObserver_Notify );
+ CleanupStack::PopAndDestroy( narrowMessage );
+ }</codeblock></context>
+</taskbody></task>
\ No newline at end of file