CCoeFep Class Reference
class CCoeFep : public CBase
|
Abstract base class for all FEPs.
FEP authors must derive a class from
CCoeFep
. The CCoeFep-derived class should implement all of its pure virtual functions including the ones which
CCoeFep
inherits from its base classes. For information on these functions, see the documentation of the base classes. The global NewFepL() function is used to create a fully initialised object of the derived class.
FEPs that need to intercept key events should own a CCoeControl-derived object. This object is referred to as the FEP control. The FEP control should be added to the control stack at a priority of ECoeStackPriorityFep, so that it receives first refusal of key events from the window server.
In general, focus is retained by the underlying application. This has the advantage that the user can see where the output produced by the FEP will go. When focus is switched between controls, the FEP must be notified in case the input capability of the focussed control changes. For instance, the FEP needs to prevent the user composing a large amount of text only for it to be passed to a newly focussed control that cannot accept text input.
CCoeFep
derives from
MCoeFocusObserver
, which enables FEPs to receive notification when the focus for the underlying control changes. The implementation of MCoeFocusObserver's functions can call the enquiry functions of class
TCoeInputCapabilities
to find out what input capabilities are supported by the new target control (you need to get the
TCoeInputCapabilities
object from the application UI first: see
CCoeAppUi::InputCapabilities()
).
NewFepL()
Nested Classes and Structures
Constructor & Destructor Documentation
CCoeFep(CCoeEnv &)
IMPORT_C
|
CCoeFep
|
(
|
CCoeEnv
&
|
aConeEnvironment
|
)
|
[protected]
|
~CCoeFep()
IMPORT_C
|
~CCoeFep
|
(
|
)
|
[virtual]
|
Member Functions Documentation
BaseConstructL(const CCoeFepParameters &)
IMPORT_C void
|
BaseConstructL
|
(
|
const
CCoeFepParameters
&
|
aFepParameters
|
)
|
[protected]
|
CCoeFep_Reserved_1()
IMPORT_C void
|
CCoeFep_Reserved_1
|
(
|
)
|
[private, virtual]
|
CCoeFep_Reserved_2()
IMPORT_C void
|
CCoeFep_Reserved_2
|
(
|
)
|
[private, virtual]
|
CancelTransaction()
void
|
CancelTransaction
|
(
|
)
|
[pure virtual]
|
Cancels the FEP transaction.
A FEP transaction begins when an event is first intercepted by the FEP and ends either when the processed text is committed to the application underneath, or if it is cancelled.
DoOnFinishingHandlingKeyEventL(TEventCode, const TKeyEvent &, TKeyResponse)
DoOnStartingHandlingKeyEventLC(TUint)
void
|
DoOnStartingHandlingKeyEventLC
|
(
|
TUint
|
aFlagNoDownUpFilter
|
)
|
[private]
|
Parameters
TUint
aFlagNoDownUpFilter
|
|
HandleMessageL(TUint32, TUid, const TDesC8 &)
IMPORT_C TMessageResponse
|
HandleMessageL
|
(
|
TUint32
|
aClientHandleOfTargetWindowGroup,
|
|
TUid
|
aMessageUid,
|
|
const
TDesC8
&
|
aMessageParameters
|
|
)
|
[private, virtual]
|
Parameters
TUint32
aClientHandleOfTargetWindowGroup
|
|
TUid
aMessageUid
|
|
const
TDesC8
& aMessageParameters
|
|
IsOn()
IMPORT_C
TBool
|
IsOn
|
(
|
)
|
const [protected]
|
IsOnHasChangedState()
void
|
IsOnHasChangedState
|
(
|
)
|
[private, pure virtual]
|
Called to notify the FEP that it has either just been turned on or just been turned off (it can find out which by calling
CCoeFep::IsOn()
).
If FEPs want to change their appearance when they are off (e.g. make themselves invisible), then they should implement this function accordingly.
IsSimulatingKeyEvent()
IMPORT_C
TBool
|
IsSimulatingKeyEvent
|
(
|
)
|
const
|
IsTurnedOffByL(const TKeyEvent &)
IsTurnedOnByL(const TKeyEvent &)
MCoeFocusObserver_Reserved_1()
IMPORT_C void
|
MCoeFocusObserver_Reserved_1
|
(
|
)
|
[private, virtual]
|
MCoeFocusObserver_Reserved_2()
IMPORT_C void
|
MCoeFocusObserver_Reserved_2
|
(
|
)
|
[private, virtual]
|
MCoeForegroundObserver_Reserved_1()
IMPORT_C void
|
MCoeForegroundObserver_Reserved_1
|
(
|
)
|
[private, virtual]
|
MCoeForegroundObserver_Reserved_2()
IMPORT_C void
|
MCoeForegroundObserver_Reserved_2
|
(
|
)
|
[private, virtual]
|
MCoeMessageObserver_Reserved_1()
IMPORT_C void
|
MCoeMessageObserver_Reserved_1
|
(
|
)
|
[private, virtual]
|
MCoeMessageObserver_Reserved_2()
IMPORT_C void
|
MCoeMessageObserver_Reserved_2
|
(
|
)
|
[private, virtual]
|
MFepAttributeStorer_Reserved_1()
IMPORT_C void
|
MFepAttributeStorer_Reserved_1
|
(
|
)
|
[private, virtual]
|
MFepAttributeStorer_Reserved_2()
IMPORT_C void
|
MFepAttributeStorer_Reserved_2
|
(
|
)
|
[private, virtual]
|
MakeDeferredFunctionCall(MDeferredFunctionCall &)
OfferKeyEventL(TEventResponse &, const TKeyEvent &, TEventCode)
OfferPointerBufferReadyEventL(TEventResponse &, const CCoeControl *)
OfferPointerEventL(TEventResponse &, const TPointerEvent &, const CCoeControl *)
OnFinishingHandlingKeyEvent_NoDownUpFilterL(TEventCode, const TKeyEvent &, TKeyResponse)
OnFinishingHandlingKeyEvent_WithDownUpFilterL(TEventCode, const TKeyEvent &, TKeyResponse)
OnStartingHandlingKeyEvent_NoDownUpFilterLC()
IMPORT_C void
|
OnStartingHandlingKeyEvent_NoDownUpFilterLC
|
(
|
)
|
|
OnStartingHandlingKeyEvent_WithDownUpFilterLC()
IMPORT_C void
|
OnStartingHandlingKeyEvent_WithDownUpFilterLC
|
(
|
)
|
|
ReadAllAttributesL()
IMPORT_C void
|
ReadAllAttributesL
|
(
|
)
|
[protected]
|
SetOnState(TBool)
void
|
SetOnState
|
(
|
TBool
|
aOnState
|
)
|
|
SimulateKeyEventsL(const TArray< TUint > &)
IMPORT_C void
|
SimulateKeyEventsL
|
(
|
const
TArray
<
TUint
> &
|
aArrayOfCharacters
|
)
|
[protected]
|
SimulateKeyEventsL(const TArray< MModifiedCharacter > &)
TurnOffKeyEventHandlingFlags(TAny *)
void
|
TurnOffKeyEventHandlingFlags
|
(
|
TAny
*
|
aFlags
|
)
|
[private, static]
|
WriteAttributeDataAndBroadcastL(TUid)
IMPORT_C void
|
WriteAttributeDataAndBroadcastL
|
(
|
TUid
|
aAttributeUid
|
)
|
[protected]
|
WriteAttributeDataAndBroadcastL(const TArray< TUid > &)
IMPORT_C void
|
WriteAttributeDataAndBroadcastL
|
(
|
const
TArray
<
TUid
> &
|
aAttributeUids
|
)
|
[protected]
|
Member Enumerations Documentation
Enum TEventResponse
Response to key or pointer event
Enumerators
EEventWasNotConsumed
|
|
EEventWasConsumed
|
< Indicates that the FEP did not process the event. < Indicates that the FEP did process the event.
|
Member Data Documentation
CCoeEnv & iConeEnvironment
CCoeEnv
&
|
iConeEnvironment
|
[private]
|
CCoeFepExtra * iExtra
CCoeFepExtra *
|
iExtra
|
[private]
|
CHighPriorityActive * iHighPriorityActive
CHighPriorityActive *
|
iHighPriorityActive
|
[private]
|
SKeyEvent * iLastKeyEvent
SKeyEvent *
|
iLastKeyEvent
|
[private]
|
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.