Class MCoeFepObserver

class MCoeFepObserver;

Description

Specifies the mixin protocol for observing a FEP transaction.

Applications which need to implement this protocol should derive from this class. The functions are not pure virtual because most applications will only need to override one of them.

Members

Defined in MCoeFepObserver:

• HandleCompletionOfTransactionL()If an application needs to get more information about a FEP transaction than is ...
• HandleStartOfTransactionL()Handles the start of a FEP transaction.
• MCoeFepObserver_Reserved_1()
• MCoeFepObserver_Reserved_2()

See also:

• CCoeFep::MakeDeferredFunctionCall(MDeferredFunctionCall &)Uses a high-priority active object to call the specified object's ExecuteFunctio...

IMPORT_C virtual void HandleStartOfTransactionL();

Description

Handles the start of a FEP transaction.

The implementation of this function might move focus to an existing edit window, or might launch a new dialog (if the dialog should appear as soon as the user starts composing their text in the FEP rather than when the text contained in the FEP is committed to it).

This function should be called by the FEP when it receives the first event which begins a FEP transaction. It should be called after using CoeFep::MakeDeferredFunctionCall() to handle the event.

The FEP calls this function indirectly by calling CCoeEnv::ForEachFepObserverCall(TCoeFepObserverFunction) passing in FepObserverHandleStartOfTransactionL. Internally, this calls MCoeFepObserver::HandleStartOfTransactionL() for each MCoeFepObserver object that has been registered with the control environment by calling CCoeEnv::AddFepObserverL(MCoeFepObserver &).

See also:

• CCoeFep::MakeDeferredFunctionCall(MDeferredFunctionCall &)Uses a high-priority active object to call the specified object's ExecuteFunctio...

IMPORT_C virtual void HandleCompletionOfTransactionL();

Description

If an application needs to get more information about a FEP transaction than is provided by the FEP framework, (for example, a Japanese FEP may want the pronunciation of the transaction's text as well as the text itself), then it should override this function to retrieve the information it wants from the FEP.

This assumes that the application knows which concrete FEP is above it so that it can call the specialised functions in that FEP. An application can safely do this by calling CCoeEnv::Fep()const to get the address of the current FEP (this is NULL if there is no FEP above it) and downcasting this address to the specific derived class of the FEP it is expecting, on condition that the CCoeEnv::FepUid()const function returns the UID of the FEP it is expecting.

This function is called by the FEP framework. If the FEP is doing inline editing, MCoeFepObserver::HandleCompletionOfTransactionL() is called inside MCoeFepAwareTextEditor's CommitFepInlineEditL(). If it isn't doing inline editing, MCoeFepObserver::HandleCompletionOfTransactionL() is called (inside an active object) after the key events generated by one or more calls to CCoeFep's SimulateKeyEventsL() have been sent to the application.

private: IMPORT_C virtual void MCoeFepObserver_Reserved_1();

Description

private: IMPORT_C virtual void MCoeFepObserver_Reserved_2();

Description