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