Key Press Profile

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.

Key profiles vary depending on the SDK used and device targeted. Therefore, you can select the desired key profile for development.

NOTE 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 Select Key Press Mapping Profile wizard page.

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.

A preference dialog is provided to create, delete, edit, import, or export a user defined workspace profile. Select Window > Preferences > Carbide.c++ > Performance Investigator to open the Key Press Trace preference window.

PI Preference

Figure 1. Key Profile Mapping

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.

Item Explanation

Duplicate

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.

Remove

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.

Edit...

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.

Import Profiles... 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 profileID argument) then a warning screen appears and lists the profile(s) that will be overwritten in the workspace.
Export Profiles... 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.
Restore Defaults This button sets the profile to the Symbian TechView (carbide built-in) profile.

 

Click Duplicate 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 Edit... to make changes to the new profile.

new key profile

Figure 2. Create New Profile

 

Click Edit... 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 Save button. Click Save to accept all entries in the table and close the dialog box.

NOTE Once hex values have been entered, they cannot be edited. However, you can remove an entry and recreate it.

Click Clear Profile if you want to clear all entries. A confirmation dialog will appear before erasing all profile entrys.

Click the Remove button to delete a selected kep map entry from the profile.

Edit key profile

Figure 3. Key Map Editor

Click the Add button in the Editing Profile name dialog to open a dialog to define a key map entry.

Add key map

Figure 4. Add Key Map Entry

Click the Edit... button in the Editing Profile name dialog to open a dialog to edit a selected key map entry.

Edit map entry

Figure 5. Edit Key Map Entry

 

Related concepts

Related references

Related task