uidesigner/com.nokia.carbide.cpp.uidesigner.doc.user/html/tasks/uidesign/task_uid_enable_view_switching.htm
author fturovic <frank.turovich@nokia.com>
Fri, 26 Jun 2009 11:16:29 -0500
changeset 308 2cf1147ef3f9
parent 0 fb279309251b
permissions -rw-r--r--
creating new project task needed reordering and updated images
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
308
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<html>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<head>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
<title>Enabling Avkon View Switching</title>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     7
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
</head>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
<body bgcolor="#FFFFFF">
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    10
<h2>Enabling Avkon View Switching</h2>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    11
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    12
<p>The New Project wizard allows you to <a href="../projects/task_proj_new-07.htm">specify that you want automated support for Avkon View Switching in your project</a>. This option must be set when the project is first created or the UI Designer will not generate the AppUi level code necessary to support view switching. Checking this option is sufficient to implement view switching automatically within projects that you have created with the wizard. </p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    13
<p>Legacy applications may already be configured to support view switching. If your legacy application is so configured, a few relatively simple manual edits to UI designs created with the S60 UI design wizard will add them to the switching group.</p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    14
<div class="step">
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    15
  <h4>Implementing Avkon View Switching in a Project </h4>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
  <ol>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    17
<li>Add Avkon View initialization code to &lt;<em>ProjectName</em>&gt;AppUi::ConstructL(). </li>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    18
    <p>You must manually instantiate your view, and register it with the View Server.</p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
    <p>Adopt the following code for your view's name, and add it to the ConstructL() method of your &lt;<em>ProjectName</em>&gt;AppUi class.</p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    20
    <p class="listing">iMyView =  CMyView::NewL();<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    21
      AddViewL( iMyView );<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    22
    <i>SetDefaultViewL(  *iMyView );  // if this  view is the default</i></p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    23
    <li>Add an enumerator for your view to the view id enumeration. </li>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    24
    <p>Open the &lt;<em>ProjectName</em>&gt;.hrh file.  It will look something like this:</p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
    <p class="listing">/*<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
      ============================================================================<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
      Descriptive Information <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
      ============================================================================<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
      */<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
      #ifndef __LEGACYPROJ_HRH__<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
      #define __LEGACYPROJ_HRH__<br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    32
      <br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
      // LegacyProj enumerate command codes<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
      enum TLegacyProjIds <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
      { <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    36
      ECommand1 = 0x6001, // start value must not be 0 <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    37
      ECommand2 <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    38
    }<br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    39
    <br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    40
    // LegacyProj view identifiers <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    41
	  enum TLegacyProjViewUids <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    42
	  { <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    43
	  ELegacyViewUid = 1 <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    44
    };<br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    45
    #endif // __LEGACYPROJ_HRH__</p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    46
    <p>You must manually edit this file to add a Uid for your view to the enumeration. Add your new identifier to the end of the list. After editing the file, it could look like this: </p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    47
    <p class="listing">/*<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    48
      ============================================================================<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    49
      Descriptive Information <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    50
      ============================================================================<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    51
      */<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    52
      #ifndef __LEGACYPROJ_HRH__<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    53
      #define __LEGACYPROJ_HRH__<br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    54
      <br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    55
      // LegacyProj enumerate command codes<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    56
      enum TLegacyProjIds <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    57
		{ <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    58
		ECommand1 = 0x6001, // start value must not be 0 <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    59
		ECommand2 <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    60
	  }<br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    61
	  <br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    62
	  // LegacyProj view identifiers <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    63
	  enum TLegacyProjViewUids <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    64
	  { <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    65
	  ELegacyViewUid = 1, <br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    66
	  EMyDesignViewUid // UID for new view, named E
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    67
	  <design name>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    68
	  ViewUid<br />
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    69
	  };<br>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    70
	  #endif // __LEGACYPROJ_HRH__</p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    71
  </ol>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    72
  <p>When you have completed these steps, the view-switching aspects of this design should build and operate successfully.</p>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    73
</div>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    74
<h5>Related tasks</h5>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    75
<ul>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    76
  <li><a href="../projects/task_proj_new.htm">Creating New GUI Projects for the UI Designer</a></li>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    77
</ul>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    78
<h5>Related references</h5>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    79
<ul>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    80
  <li><a href="../../reference/projects/ref_new_proj_wizard.htm">New Project Wizard</a></li>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    81
</ul>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    82
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    83
<div id="footer">Copyright &copy; 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    84
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    85
</body>
2cf1147ef3f9 creating new project task needed reordering and updated images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    86
</html>