Appendix. Emulator Shortcut Keys

The Series 60 emulator is the primary development and debugging tool for Series 60 Symbian OS application development. It provides PC keyboard combinations for accessing special testing and logging functionality and also for mimicking the hardware keys of an actual device. Most of these shortcuts are specifically for the debug emulator, but some of the hardware emulation ones will work with the release emulator also. Note, too, that some of the shortcuts defined are inherited from Symbian OS and are not really relevant for Series 60.

The available keyboard shortcuts are as listed in Tables A-1 through A-5.

Table A-1. Drawing

Shortcut Key

Description

Ctrl + Alt + Shift + R

Redraws the whole screen, to test an application's redraw functionality.

Ctrl + Alt + Shift + F

Enables Window Server auto-flush for all applications using the current control environment. This can be used to slow down drawing for finding flicker problems.

Ctrl + Alt + Shift + G

Disables Window Server auto-flush for all applications using the current control environment. This is the default setting.

Ctrl + Alt + Shift + M

Displays a "Move me!" dialog to test partial redraw, which can be moved using the navigation keys. Note that multiple instances can be nested, but there is no benefit in this.

Ctrl + Alt + Shift + Enter

Displays a "Move me!" dialog, as above.


Table A-2. Window Server [*]

Shortcut Key

Description

Ctrl + Alt + Shift + E

Enables logging of all Window Server messages (if logging is set up).

Ctrl + Alt + Shift + D

Disables Window Server logging, if active.

Ctrl + Alt + Shift + W

Dumps the full window tree from the Window Server to the log (if logging is set up). If disabled, logging will be temporarily enabled to achieve this.

Ctrl + Alt + Shift + K

Kills the foreground application.

Ctrl + Alt + Shift + X

Shuts down the Window Server.

Ctrl + Alt + Shift + H

Dumps the list of cells allocated on the Window Server's heap to the log (if logging is set up).

Ctrl + Alt + Shift + U

Cycles the display through its possible sizes. Note that a display of size 176 by 208 pixels is the only currently available option in Series 60. (This shortcut is inherited from Symbian OS.)

Ctrl + Alt + Shift + O

Cycles the screen orientation through its possible rotations . For Series 60, these are 180 degrees apart. Note that for legibility it flips the emulator rather than the screen.

Ctrl + Alt + Shift + T

Displays the task switcher ”a list of currently running applications, which can be switched to. This is similar to a long press of the Applications key, which should be used in preference, as it is guaranteed to produce up-to-date results. (This shortcut is inherited from Symbian OS.)

Ctrl + Alt + Shift + I

Dumps the control tree to the IDE debug output window for the next window clicked on.

Ctrl + Alt + Shift + J

Draws colored borders around all controls.

Ctrl + Alt + Shift + L

Shuts all dialogs using AknDialogShutter .

For further information on Window Server logging, see " How to set up window server logging" in the Symbian OS API Guide section of the SDK documentation. Note, however, that there is a known defect with Window Server logging in Series 60 1.x ”see Forum Nokia ( http://www.forum.nokia.com ) for further details of known Series 60 defects.


Table A-3. Resource Allocation

Shortcut Key

Description

Ctrl + Alt + Shift + A

Displays the number of heap cells allocated by the current application. Note that this value cannot be clearly seen on a Series 60 emulator screen! (This shortcut is inherited from Symbian OS.)

Ctrl + Alt + Shift + B

Displays the number of File Server resources in use by the current application. Note that this value cannot be clearly seen on a Series 60 emulator screen! (This shortcut is inherited from Symbian OS.)

Ctrl + Alt + Shift + C

Displays the number of Window Server resources in use by the current application. Note that this value cannot be clearly seen on a Series 60 emulator screen! (This shortcut is inherited from Symbian OS.)

Ctrl + Alt + Shift + P

Displays the dialog for the resource failure tool. The application heap can be set to fail at a random or deterministic rate, Window Server operations can be set to fail at a random or deterministic rate, and File access can be set to fail at a deterministic rate.

See Chapter 13 for more information on Heap Testing.

Ctrl + Alt + Shift + Q

Turns off heap failure mode. Note that the resource failure tool dialog will not be updated if it is open .


Table A-4. Hardware Emulation [*]

Shortcut Key

Description

`

(The key to the left of 1)

Equivalent to the Selection key (center of the navigation keys).

Alt + 1

Equivalent to the left soft key.

Alt + 2

Equivalent to the right soft key.

Cursor keys

Equivalent to the navigation keys.

9, * and #

Equivalent to the ITU-T numeric keypad.

Alt +

Equivalent to the power-off key. Note that in most emulators the power key has no effect.

Alt + 3

Equivalent to grip open, to emulate a device with a hideaway keypad opening.

Alt + 4

Equivalent to grip closed, to emulate a device with a hideaway keypad closing.

Alt + 5

Equivalent to the side key.

Alt + S

Equivalent to the Send call key.

Alt + E

Equivalent to the End call key. Note that this will switch to the phone application on target only.

Home

Equivalent to the Applications key.

Ctrl + H or Backspace

Equivalent to the Clear key.

Shift

Equivalent to the Edit key.


[*] Note that the mappings of some of these keys may be changed in the \Epoc32\Data\Epoc.ini file.

Table A-5. Miscellaneous

Shortcut Key

Description

Ctrl + Alt + Shift + V

Toggles verbose information messages. Text in calls to CEikonEnv::VerboseInfoMsg will be displayed.

Ctrl + Alt + Shift + N

Toggles the Active Scheduler shaker.

Ctrl + Alt + Shift + Y

Mounts a file system as the x: drive for testing removable media support. Will actually fail with a system error! (This shortcut is inherited from Symbian OS.)

Ctrl + Alt + Shift + Z

Sends the keys A though J in fast sequence to the application, to test its ability to handle fast repeated keys.

(Numeric keypad) +

(The "+" key on the numeric keypad) ”Toggles the Front End Processor (FEP) status display. This shows the status and current mode of the FEP.

Alt + F

Toggles the FEP state on or off.

Esc

Cancels any shown dialogs or menus .

F1

Shows the current options menu. (Note that this will occur even if no Options soft key is currently specified!)

F5

Simulates changing removable media cards ”not used in Series 60. (This shortcut is inherited from Symbian OS.)

F9

Power off. (Turns off the emulator.)

F10

Simulates an emergency shutdown (in other words, what would occur if battery levels dropped below the minimum level). No user operations are allowed. F9 will power it back up.

F11

Simulates a device's case being opened or closed. Not used in Series 60 ”see grip open/close events. (This shortcut is inherited from Symbian OS.) [*]


[*] Note, however that pressing F11 twice (to "open and close the case") can be used to wake up a frozen emulator. (When waiting at an application breakpoint for a long time, the emulator can go into sleep mode.)



Developing Series 60 Applications. A Guide for Symbian OS C++ Developers
Developing Series 60 Applications: A Guide for Symbian OS C++ Developers: A Guide for Symbian OS C++ Developers
ISBN: 0321227220
EAN: 2147483647
Year: 2003
Pages: 139

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net