Symbian3/SDK/Source/GUID-2BD20EF8-B6B8-4A1B-8B0D-3326B839FD37.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Wed, 31 Mar 2010 11:11:55 +0100
changeset 7 51a74ef9ed63
permissions -rw-r--r--
Week 12 contribution of API Specs and fix SDK submission

<?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-2BD20EF8-B6B8-4A1B-8B0D-3326B839FD37" xml:lang="en"><title>Constructing
a dialog</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>Constructing and running a <xref format="html" href="specs/guides/Dialogs_API_Specification/Dialogs_API_Specification.html" scope="peer">dialogs</xref> is simple:</p>
<codeblock id="GUID-E91FFC65-C45C-41F0-924F-F8ECE8F4B9AA" xml:space="preserve">void CDlgappAppUi::ConstructL()
    {
    BaseConstructL();
    iAppView = new (ELeave) CDlgAppMainView;
    iAppView-&gt;ExecuteLD(R_DLGAPP_MAIN_DIALOG); // modeless
    AddToStackL(iAppView);
    }
</codeblock>
<p>Because the dialog is modeless, <xref href="GUID-DC21E927-18B3-3BBF-9B67-496F2D158B03.dita#GUID-DC21E927-18B3-3BBF-9B67-496F2D158B03/GUID-FFDBADFA-A642-321A-9125-C7A78FC718C4"><apiname>CEikDialog::ExecuteLD()</apiname></xref> returns
immediately after being called. The dialog can (and must) be added to the
control stack with the <xref href="GUID-3AC2CDAC-0291-309F-A020-049BC9F2CF90.dita#GUID-3AC2CDAC-0291-309F-A020-049BC9F2CF90/GUID-3CB7F46F-FF5D-3F96-B478-1E83CC7CDE17"><apiname>CCoeAppUi::AddToStackL()</apiname></xref> method,
because modeless dialogs do not do this for themselves.</p>
<p>The application extends the dialog just as it would normally extend
a <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>-derived view in order to achieve the desired
functionality. For more information, see <xref href="GUID-B5DE1C86-2B16-4B22-887F-7079E54A8ED6.dita">Traditional
Symbian UI application architecture</xref>.</p>
</conbody></concept>