|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
|
2 "http://www.w3.org/TR/html4/loose.dtd"> |
|
3 <html> |
|
4 <head> |
|
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
|
6 <meta name="keywords" content="Performance Investigator"> |
|
7 <title>Key Press Mapping</title> |
|
8 <link href="../../../book.css" rel="stylesheet" type="text/css"> |
|
9 </head> |
|
10 |
|
11 <body> |
|
12 <h2>Key Press Profile</h2> |
|
13 <p>If the Button Push Capture profile option was on during a profiling session, then Key presses are traced and saved in the profiler's .dat file as hex numbers. When a .dat file is imported, key press events are converted to key label strings and saved in the NPI file; and loses the original hex number.</p> |
|
14 <p>Key profiles vary depending on the SDK used and device targeted. Therefore, you can select the desired key profile for development.</p> |
|
15 <p class="note"><strong>NOTE</strong> The key profile selected in the Manage Profiles list serves as the suggested global default for profiler .dat files that are imported. When importing a .dat file (File > Import > Performance Investigator > Performance Investigator Data) this default profile will be highlighted in the <strong>Select Key Press Mapping Profile</strong> wizard page.</p> |
|
16 <p>The key layout mapping is maintained in a XML file. You can select from predefined built-in profiles or create your own key profile and save it to a XML file.</p> |
|
17 <p>A preference dialog is provided to create, delete, edit, import, or export a user defined workspace profile. Select <strong>Window > Preferences > Carbide.c++ > Performance Investigator</strong> to open the Key Press Trace preference window.</p> |
|
18 <p align="center"><img src="images/pi_pref.png" alt="PI Preference" width="663" height="563"></p> |
|
19 <p align="center" class="figure">Figure 1. Key Profile Mapping </p> |
|
20 <p>In the Manage Profiles group you can select a user-defined or built-in key map profile for the device targeted by your current development. Developing for different devices may require different key layouts. Built-in key profiles are displayed as Read only. New profiles you create can be edited.</p> |
|
21 <table width="100%" border="0" cellpadding="2" cellspacing="0" > |
|
22 <tr> |
|
23 <th width="27%" scope="col">Item</th> |
|
24 <th width="62%" scope="col">Explanation</th> |
|
25 </tr> |
|
26 <tr> |
|
27 <td style="vertical-align: top;"><p><strong>Duplicate</strong></p></td> |
|
28 <td style="vertical-align: top;"><p>Opens a Duplicate Profile dialog for you to define a name for a new key map profile and select a built-in profile to base it on.</p> </td> |
|
29 </tr> |
|
30 <tr > |
|
31 <td valign="top"><strong>Remove</strong></td> |
|
32 <td valign="top"><p >This button is enabled when a user defined workspace profile is selected and will delete the currently selected user profile. A confirmation dialog will appear before removing the profile. </p> </td> |
|
33 </tr> |
|
34 <tr> |
|
35 <td style="vertical-align: top;"><strong>Edit...</strong></td> |
|
36 <td style="vertical-align: top;"><p>This button is enabled when a user defined workspace profile is selected and will open an Editing Profile dialog. You can Add, Remove, and Edit key map entries for your profile. </p> </td> |
|
37 </tr> |
|
38 <tr> |
|
39 <td style="vertical-align: top;"><strong><a href="key_profile_imp.htm">Import Profiles...</a></strong></td> |
|
40 <td style="vertical-align: top;">Opens a Key Press Profile Import Wizard to allow you to enter or select path and filename of a key profile XML file. If a profile exists in the workspace with the same name of a profile defined in imported XML file (identified by <strong>profileID</strong> argument) then a warning screen appears and lists the profile(s) that will be overwritten in the workspace.</td> |
|
41 </tr> |
|
42 <tr> |
|
43 <td style="vertical-align: top;"><strong><a href="key_profile_exp.htm">Export Profiles...</a></strong></td> |
|
44 <td style="vertical-align: top;">Opens a Key Press Profile Export Wizard to allow you to define or select a key profile XML file that will store user defined profiles. All user defined workspace profiles will be exported to one XML file. The Export function does not export built-in key profiles. By exporting all your profiles to one XML file you can provide a single XML file for a family of devices.</td> |
|
45 </tr> |
|
46 <tr> |
|
47 <td style="vertical-align: top;"><strong>Restore Defaults</strong> </td> |
|
48 <td style="vertical-align: top;">This button sets the profile to the Symbian TechView (carbide built-in) profile.</td> |
|
49 </tr> |
|
50 </table> |
|
51 <p> </p> |
|
52 <p><a name="newkeyprof"></a>Click <strong>Duplicate</strong> to create a new profile. Enter a name for the profile and select a built-in profile to base your new profile on. After creating a new profile, it will appear in the Key Press Trace window. You can then click <strong>Edit...</strong> to make changes to the new profile.</p> |
|
53 <p align="center"><img src="images/pi_pref_new.png" alt="new key profile" width="366" height="198"></p> |
|
54 <p align="center" class="figure">Figure 2. Create New Profile</p> |
|
55 <p> </p> |
|
56 <p><a name="editkeymap"></a>Click <strong>Edit...</strong> to open a dialog for modifying key map entries for the profile. An Add, Remove, and Edit... button are provided to create a key mapping, delete a single selected entry, or modify a single key map entry. New or edited entries appear as Bold text in the table until you click the <strong>Save</strong> button. Click <strong>Save</strong> to accept all entries in the table and close the dialog box.</p> |
|
57 <p class="note"><strong>NOTE</strong> Once hex values have been entered, they cannot be edited. However, you can remove an entry and recreate it.</p> |
|
58 <p>Click <strong>Clear Profile</strong> if you want to clear all entries. A confirmation dialog will appear before erasing all profile entrys.</p> |
|
59 <p>Click the <strong>Remove</strong> button to delete a selected kep map entry from the profile.</p> |
|
60 <p align="center"><img src="images/pi_pref_edit.png" alt="Edit key profile" width="515" height="340"></p> |
|
61 <p align="center" class="figure">Figure 3. Key Map Editor</p> |
|
62 <p align="left"><a name="addkeymap"></a>Click the <strong>Add</strong> button in the <strong>Editing Profile <em>name</em></strong> dialog to open a dialog to define a key map entry. </p> |
|
63 <p align="center"><img src="images/pi_pref_add.png" alt="Add key map" width="293" height="186"></p> |
|
64 <p align="center" class="figure">Figure 4. Add Key Map Entry </p> |
|
65 <p align="left"><a name="editkeyentry"></a>Click the <strong>Edit...</strong> button in the <strong>Editing Profile <em>name</em></strong> dialog to open a dialog to edit a selected key map entry.</p> |
|
66 <p align="center"><img src="images/pi_pref_edit_entry.png" alt="Edit map entry" width="293" height="158"> </p> |
|
67 <p align="center" class="figure">Figure 5. Edit Key Map Entry </p> |
|
68 <p align="left"> </p> |
|
69 <p><strong>Related concepts </strong></p> |
|
70 <ul> |
|
71 <li><a href="../../reference/profiler/prof_using.htm">Button Press Capture</a> </li> |
|
72 </ul> |
|
73 <p><strong>Related references</strong></p> |
|
74 <ul> |
|
75 <li><a href="../profiler/btn_press_enable.htm">Setting the Button Press Capture Option</a></li> |
|
76 <li><a href="btn_press_show.htm">Showing/Hiding Button Events</a></li> |
|
77 </ul> |
|
78 <p><strong>Related task</strong></p> |
|
79 <ul> |
|
80 <li><a href="key_profile_switch.htm">Switch Key Map Profile</a></li> |
|
81 <li><a href="btn_press_change.htm">Changing Button Event Information</a> </li> |
|
82 </ul> |
|
83 <div id="footer">Copyright © 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> |
|
84 </body> |
|
85 </html> |