Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Archived:Camera shutter key (EKeyCamera events) cannot be used in 3rd party applications (Known Issue)

From Wiki
Jump to: navigation, search

Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

The camera shutter key cannot be used for capturing images, because it is reserved for the system camera application.

Article Metadata
Tested with
Devices(s): All devices that have a camera shutter key (e.g., Nokia N70, Nokia N90)
Devices without AutoFocus capability
Keywords: EKeyCamera
Created: User:Technical writer 1 (25 Jan 2007)
Last edited: hamishwillee (18 Jun 2012)


The SDK header eikon.hrh lists the key code for the camera shutter key (EKeyCamera). However, key events from EKeyCamera are consumed and sent to the system camera application only, and cannot be captured by 3rd parties.


No solution available (for EKeyCamera events).

Devices with AutoFocus capability:

Devices that have a camera with AutoFocus capability use a different key code for the shutter key. Events from this key can be captured if the application has SwEvent capability.

#define EKeyCameraShutter 0xf883
#define EKeyCameraShutter2 0xf849 // S60 3rd Ed, FP2

Events from this key need to be explicitly requested from the window server:

// Capture events from the camera shutter key
// (SwEvent capability required)
iCameraKeyHandle =
iCoeEnv->RootWin().CaptureKey( EKeyCameraShutter, 0, 0 );

The return value iCameraKeyHandle (TInt32) is used for canceling the key capture request, typically when exiting the application:

if ( iCameraKeyHandle >= 0 )

Focus key events:

Pressing the shutter key halfway down generates separate key events. EEventKeyDown and EEventKeyUp events from this key can be detected with the following scan code:

#define EStdKeyCameraFocus 0xe2
#define EStdKeyCameraFocus2 0xeb // S60 3rd Ed, FP2
This page was last modified on 18 June 2012, at 06:16.
63 page views in the last 30 days.