How to configure virtual keys

Virtual keys are represented as rectangular regions of the screen. The VirtualKey keyword allows developers to emulate target machine keys drawn on the fascia bitmap. The process is:

1. Open epoc.ini in a text editor. It can be found at .\epoc32\data\.

2. Enter the keyword VirtualKey, followed by the key code the region is to produce, the shape of the region and the shape parameters. For example:

   VirtualKey key-code shape shape-parameters

3. Save the file.

VirtualKey EStdKeyMenu rect 50,60 30,20

• The names used for the Symbian key codes are defined in .\epoc32\include\E32keys.h

• The syntax will allow different shapes, but the only shape supported is rect which specifies a rectangle.

• The additional parameters are the co-ordinates for the top left of the rectangle and its width and height.

• A non rectangular key can be approximated with one or more rectangles, for example an elliptical key can be approximated with 3 or 5 rectangles.

• Overlapping virtual keys will be prioritised according to the order in which they are specified in the configuration file, with the later entries having higher priority.

• The cursor will change into a hand when over a virtual key.