Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: fepbase.h
Link against: fepbase.lib

FEP_END_KEY_EVENT_HANDLER_L

#define FEP_END_KEY_EVENT_HANDLER_L(aFep, aKeyEvent, aKeyResponse)\
    {\
    return (aFep).OnFinishingHandlingKeyEvent_WithDownUpFilterL(EEventKey, (aKeyEvent), (aKeyResponse));\
    }

Support

Supported from 6.1

Description

Macro to be called by a keyboard-based FEP to return from its CCoeControl::OfferKeyEventL()-overriding function.

It should be used instead of the return statement. It should only be used if the FEP_START_KEY_EVENT_HANDLER_L macro was used at the start of the function.

Parameters

aFep

The FEP that owns the control implementing OfferKeyEventL().

aKeyEvent

The key event (of type TKeyEvent), as passed to OfferKeyEventL().

aKeyResponse

Indicates whether or not OfferKeyEventL() consumed the key event. Specifying EKeyWasNotConsumed allows that event to pass through to the underlying application, specifying EKeyWasConsumed prevents the application from receiving the event. A good rule of thumb for a FEP that takes key events as its input is to consume as few key events as possible when not inside a FEP transaction, but once inside a transaction to block all key events from getting through to the application.