Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <FEPBUTILS.H>

FEP_START_KEY_EVENT_HANDLER_L

FEP_START_KEY_EVENT_HANDLER_L (aFep, aKeyEvent, aEventCode) {\
    if ((aFep).IsSimulatingKeyEvent())\
        {\
        return EKeyWasNotConsumed;\
        }\
    (aFep).OnStartingHandlingKeyEvent_WithDownUpFilterLC();\
    if (((aEventCode)!=EEventKey))\
        {\
        return (aFep).OnFinishingHandlingKeyEvent_WithDownUpFilterL((aEventCode), (aKeyEvent), EKeyWasConsumed);\
        }\
    if (!(aFep).IsOn())\
        {\
        return (aFep).OnFinishingHandlingKeyEvent_WithDownUpFilterL((aEventCode), (aKeyEvent), EKeyWasNotConsumed);\
        }\
    }

Description

Macro to be called by a keyboard-based FEP at the start of its CCoeControl::OfferKeyEventL()-overriding function.

It causes key up and key down events to be consumed so that the FEP only receives standard key events (of type EEventKey, see the TEventCode enumeration). It also causes key events that turn the FEP on or off to be consumed. If the FEP is simulating key events, or is off, no key events are consumed (so that all are passed on to the underlying application) and the macro returns with EKeyWasNotConsumed.

This should be the first thing called in the OfferKeyEventL() function. The FEP_END_KEY_EVENT_HANDLER_L macro should be used to return from the function.

Parameters

aFep

The CCoeFepCCoeFep object, should not be a pointer

aKeyEvent

The TKeyEventTKeyEvent object from OfferKeyEventL()

aEventCode

The TEventCode object from OfferKeyEventL()

See also:

[Top]


FEP_END_KEY_EVENT_HANDLER_L

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

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 CCoeFepCCoeFep object, should not be a pointer

aKeyEvent

The TKeyEventTKeyEvent object from OfferKeyEventL()

aKeyResponse

Defined in EPOC32.H If set to EKeyWasNotConsumed, allows the key event to reach the underlying application. If set to EKeyWasConsumed, prevents the key event reaching the underlying application.

[Top]


FEP_START_KEY_EVENT_HANDLER_NO_DOWN_UP_FILTER_L

FEP_START_KEY_EVENT_HANDLER_NO_DOWN_UP_FILTER_L (aFep, aKeyEvent, aEventCode) {\
    if ((aFep).IsSimulatingKeyEvent())\
        {\
        return EKeyWasNotConsumed;\
        }\
    (aFep).OnStartingHandlingKeyEvent_NoDownUpFilterLC();\
    if ((aEventCode)==EEventKey)\
        {\
        if (!(aFep).IsOn())\
            {\
            return (aFep).OnFinishingHandlingKeyEvent_NoDownUpFilterL((aEventCode), (aKeyEvent), EKeyWasNotConsumed);\
            }\
        }\
    }

Description

Macro to be called by a keyboard-based FEP at the start of its CCoeControl::OfferKeyEventL()-overriding function.

It causes events that turn the FEP on or off to be consumed. This variant of the macro ignores key up and key down events so that it should be used in preference to FEP_START_KEY_EVENT_HANDLER_L in the rare cases where the FEP wishes to handle EEventKeyDown or EEventKeyUp events. If the FEP is simulating key events, or is off, no key events are consumed and OfferKeyEventL() returns with EKeyWasNotConsumed.

This should be the first thing called in the OfferKeyEventL() function. The FEP_END_KEY_EVENT_HANDLER_NO_DOWN_UP_FILTER_L macro should be used to return from the function.

Parameters

aFep

The CCoeFepCCoeFep object, should not be a pointer

aKeyEvent

The TKeyEventTKeyEvent object from OfferKeyEventL()

aEventCode

The TEventCode object from OfferKeyEventL()

[Top]


FEP_END_KEY_EVENT_HANDLER_NO_DOWN_UP_FILTER_L

FEP_END_KEY_EVENT_HANDLER_NO_DOWN_UP_FILTER_L (aFep, aKeyEvent, aEventCode, aKeyResponse) {\
    return (aFep).OnFinishingHandlingKeyEvent_NoDownUpFilterL((aEventCode), (aKeyEvent), (aKeyResponse));\
    }

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. This variant of the macro should only be used if the FEP_START_KEY_EVENT_HANDLER_NO_DOWN_UP_FILTER_L macro was used at the start of the function.

Parameters

aFep

The CCoeFepCCoeFep object, should not be a pointer

aKeyEvent

The TKeyEventTKeyEvent object from OfferKeyEventL()

aEventCode

The TEventCode object from OfferKeyEventL()

aKeyResponse

Defined in EPOC32. If set to EKeyWasNotConsumed, allows the key event to reach the underlying application. If set to EKeyWasConsumed, prevents the key event reaching the underlying application.