Symbian3/SDK/Source/GUID-2BD20EF8-B6B8-4A1B-8B0D-3326B839FD37.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-2BD20EF8-B6B8-4A1B-8B0D-3326B839FD37.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,31 @@
+<?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>
\ No newline at end of file