Symbian3/SDK/Source/GUID-A399508A-DE6A-490D-9BFB-4FCF56FF9D4C.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-A399508A-DE6A-490D-9BFB-4FCF56FF9D4C.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,59 @@
+<?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-A399508A-DE6A-490D-9BFB-4FCF56FF9D4C" xml:lang="en"><title>Derive
+a class from the MCoeView class</title><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<context>       <p>Derive a class from the <codeph>MCoeView</codeph> class
+and provide the definition for each of the following functions:</p><ul>
+<li><p><codeblock xml:space="preserve">TVwsViewId ViewId() const</codeblock></p><p>This function
+defines the unique identifier of the view within the given application.</p></li>
+</ul><ul>
+<li><p><codeblock xml:space="preserve">void ViewActivatedL(const TVwsViewId&amp; aPrevViewId,TUid aCustomMessageId,const TDesC8&amp; aCustomMessage)</codeblock></p><p>This is the function is called by the operating system when a view is activated.
+The call gets several arguments: the view ID of the previous view that was
+displayed (in case a switch back to it is desired), and the identifier and
+text of a message that comes from the process that is activating the view.
+This message can convey specialized information, such as information on what
+to display, from the activating process.</p></li>
+</ul><ul>
+<li><p><codeblock xml:space="preserve">void ViewDeactivated()</codeblock></p><p>This function is
+called by the operating system when a view is deactivated. </p></li>
+</ul><ul>
+<li><p><codeblock xml:space="preserve">TVwsViewIdAndMessage ViewScreenDeviceChangedL()</codeblock></p><p>This
+function has a default implementation. It handles a change to the screen device
+returning the value of the <codeph>TVwsViewIdAndMessage</codeph> object. By
+default, returns the ID of the active view.</p><p>Cone provides a default
+screen device change handler <codeph>CCoeScreenDeviceChangeDefaultHandler</codeph>. <codeph>CCoeScreenDeviceChangeDefaultHandler</codeph> handles
+any screen device changes that occur while a view is active. It is used to
+activate a default view when a screen flip (changing the screen orientation,
+for example, landscape to portrait) occurs, if the currently active view does
+not implement <codeph>MCoeView::ViewScreenDeviceChangedL()</codeph>.</p></li>
+</ul><p>The following code snippet shows deriving a class from <codeph>MCoeView</codeph> and
+implementing the required functions:</p><codeblock xml:space="preserve">class CNewView : public MCoeView
+    {
+    public:
+        //construction
+        CNewView( const TVwsViewId&amp; aViewId, CCoeAppUi&amp; aAppUi );
+        void ConstructL();
+        ~CNewView();
+    private:
+        // From MCoeView class
+        void ViewActivatedL( const TVwsViewId&amp; aPrevViewId, 
+                             TUid aCustomMessageId, 
+                             const TDesC8&amp; aCustomMessage );    
+        void ViewDeactivated();
+        TVwsViewIdAndMessage ViewScreenDeviceChangedL();
+        void ViewConstructL();
+    private:
+        CCoeAppUi&amp; iCCoeAppUi;
+        TVwsViewId&amp; iViewId;
+    };
+</codeblock></context>
+</taskbody></task>
\ No newline at end of file