<?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&amp; aViewId )

</codeblock></li>

<li><p>View activation with custom message.</p><codeblock xml:space="preserve">CCoeAppUi::ActivateViewL( TVwsViewId&amp; aViewId TUid aCustomMessageId,

                          TDesC8&amp; 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&amp; aViewId,TUid aCustomMessageId,const TDesC16&amp; 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>