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 concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-F0185CC2-C175-556E-A4BB-0D781487817A" xml:lang="en"><title>EmbeddingShell:

    13 embedded pictures</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <section><title>Description</title> <p> <filepath>EmbeddingShell</filepath> provides

    15 an application shell, and a concrete control. </p> <p> <codeph>CGraphicExampleControl</codeph> is

    16 a control class, derived from <codeph>CCoeControl</codeph>, which links the

    17 app shell to the concrete control. </p> <p>The <codeph>CPictureControl</codeph> class,

    18 derived from <codeph>CGraphicExampleControl</codeph>, illustrates the drawing

    19 of pictures and how they can be stored to and restored from a direct file

    20 store. </p> </section>

    21 <section id="GUID-9E6294AC-8786-5F17-AC96-072811C39910"><title>Download</title> <p>Click

    22 on the following link to download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-59ec3e53-8f45-422f-859a-9cbc545ba36b.zip" scope="external">Embedding.zip</xref></p>Download some additional files required

    23 by the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-a92c7d47-fa68-49c6-9e43-c9c2e650f219.zip" scope="external">CommonGraphicsExampleFiles</xref><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-59ec3e53-8f45-422f-859a-9cbc545ba36b.html" scope="peer">browse</xref> to view the example code. </p>View the additional

    24 files: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-a92c7d47-fa68-49c6-9e43-c9c2e650f219.html" scope="peer">browse</xref>.  </section>

    25 <section><title>Class Summary</title><p><xref href="GUID-829D57CD-9659-347B-AAE9-5F0A0ECD555C.dita"><apiname>CPicture</apiname></xref></p><p><xref href="GUID-F991FEDD-DF42-390F-97E4-4204EB05AAB8.dita"><apiname>MPictureFactory</apiname></xref></p><p><xref href="GUID-8B713854-7858-3E02-8A1C-B3E6C1C9EA85.dita"><apiname>CDirectFileStore</apiname></xref></p><p><xref href="GUID-346D4908-15C7-3F15-945F-D561E774022D.dita"><apiname>RStoreWriteStream </apiname></xref></p><p><xref href="GUID-4FA6EE6C-5B4E-39E0-B888-ABDE19985976.dita"><apiname>RStoreReadStream</apiname></xref></p><p><xref href="GUID-1C4D4AFD-85E2-3D5D-B704-D1FA0E5E7DA2.dita"><apiname>TStreamId</apiname></xref></p><p><xref href="GUID-D10FA32F-32F7-3488-9AAC-CB95270EA006.dita"><apiname>TSwizzle</apiname></xref></p><p><xref href="GUID-E263C747-946F-35AA-9F1D-41833BD350FC.dita"><apiname>RFs</apiname></xref></p></section>

    26 <section><title>Build</title> <p>The source code for this example application

    27 can be found in the directory: </p> <p> <filepath>examples\Graphics\Embedding</filepath>  </p> <p>It

    28 may be in the directory in which you installed Symbian platform, or it may

    29 be in <filepath>src\common\developerlibrary\</filepath>. It includes the two

    30 project files needed for building: <filepath>bld.inf</filepath> and the <filepath>.mmp</filepath> file. </p> <p> <xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">The Symbian platform build

    31 process</xref> describes how to build this application. For the emulator,

    32 an application called <filepath>EmbeddingShell.exe</filepath> is created in <filepath>epoc32\release\winscw\&lt;udeb

    33 or urel&gt;\</filepath>. </p> </section>

    34 <section><title>Usage</title> <ol id="GUID-A6E6F210-0629-52EA-B60B-097553214F7D">

    35 <li id="GUID-EC1232A9-EB05-532D-B253-691BA2E3853C"><p>Launch the emulator: </p> <p> <filepath>epoc32\release\winscw\&lt;urel

    36 or udeb&gt;\EPOC.EXE</filepath>. </p> </li>

    37 <li id="GUID-7D3D6DAA-38E5-5678-B19C-166751A84733"><p>Click on <systemoutput>EMBEDDINGSHELL</systemoutput> to

    38 run the application. If using the <i>TechView</i> emulator, this will be in

    39 the <i>Extras</i> menu. </p> </li>

    40 <li id="GUID-BEF4EDFE-D1BB-5F7C-B76A-D8FE15AC522B"><p>Start the example by

    41 choosing <codeph>Picture</codeph> from the menu <systemoutput>List of Programs</systemoutput>. </p> </li>

    42 <li id="GUID-C04B69D1-744E-5EE1-821D-A1E548D8C136"><p>Step through each phase

    43 of the example by pressing the space bar or by tapping on the window drawn

    44 by that example. </p> </li>

    45 </ol> </section>

    46 </conbody></concept>