<?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 concept

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

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

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

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

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

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

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

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

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

store. </p> </section>

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

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

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

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

<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>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

</ol> </section>

</conbody></concept>