2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
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 |
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, |
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". --> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
6 <!-- Initial Contributors: |
6 <!-- Initial Contributors: |
7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-2BD20EF8-B6B8-4A1B-8B0D-3326B839FD37" xml:lang="en"><title>Constructing |
9 --> |
10 a dialog</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
10 <!DOCTYPE concept |
11 <p>Constructing and running a dialog is quite straightforward:</p> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <codeblock xml:space="preserve" id="GUID-E91FFC65-C45C-41F0-924F-F8ECE8F4B9AA">void CDlgappAppUi::ConstructL() |
12 <concept id="GUID-2BD20EF8-B6B8-4A1B-8B0D-3326B839FD37" xml:lang="en"><title>Constructing |
|
13 a dialog</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <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> |
|
15 <codeblock id="GUID-E91FFC65-C45C-41F0-924F-F8ECE8F4B9AA" xml:space="preserve">void CDlgappAppUi::ConstructL() |
13 { |
16 { |
14 BaseConstructL(); |
17 BaseConstructL(); |
15 iAppView = new (ELeave) CDlgAppMainView; |
18 iAppView = new (ELeave) CDlgAppMainView; |
16 iAppView->ExecuteLD(R_DLGAPP_MAIN_DIALOG); // modeless |
19 iAppView->ExecuteLD(R_DLGAPP_MAIN_DIALOG); // modeless |
17 AddToStackL(iAppView); |
20 AddToStackL(iAppView); |
18 } |
21 } |
19 </codeblock> |
22 </codeblock> |
20 <p>Because the dialog is modeless, <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCEikDialog.html#2bb826c038d23806445872d768e7d151" format="application/java-archive"><parmname>CEikDialog::ExecuteLD()</parmname></xref> returns |
23 <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 |
21 immediately after being called. The dialog can (and must) be added to the |
24 immediately after being called. The dialog can (and must) be added to the |
22 control stack with the <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/reference/reference-cpp/Control_Environment/CCoeAppUiClass.html#%3a%3aCCoeAppUi%3a%3aAddToStackL%28CCoeControl%20%2a%2cTInt%2cTInt%29" format="application/java-archive"><parmname>CCoeAppUi::AddToStackL()</parmname></xref> method, because |
25 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, |
23 modeless dialogs do not do this for themselves.</p> |
26 because modeless dialogs do not do this for themselves.</p> |
24 <p>The application extends the dialog just as it would normally extend |
27 <p>The application extends the dialog just as it would normally extend |
25 a <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/reference/reference-cpp/Control_Environment/CCoeControlClass.html" format="application/java-archive"><parmname>CCoeControl</parmname></xref>-derived view in order to achieve |
28 a <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref>-derived view in order to achieve the desired |
26 the desired functionality. For more information, see <xref href="GUID-B5DE1C86-2B16-4B22-887F-7079E54A8ED6.dita">Traditional |
29 functionality. For more information, see <xref href="GUID-B5DE1C86-2B16-4B22-887F-7079E54A8ED6.dita">Traditional |
27 Symbian UI application architecture</xref>.</p> |
30 Symbian UI application architecture</xref>.</p> |
28 </conbody></concept> |
31 </conbody></concept> |