MCoeControlObserver Class Reference

#include <mw/coecobs.h>

Link against: cone.lib

class MCoeControlObserver
Public Member Enumerations
enumTCoeEvent { EEventRequestExit, EEventRequestCancel, EEventRequestFocus, EEventPrepareFocusTransition, ..., EEventInteractionRefused }
Public Member Functions
pure virtual voidHandleControlEventL(CCoeControl *, TCoeEvent)
Protected Member Functions
MCoeControlObserver()

Detailed Description

Interface for a control to send events to its observer control.

Member Enumeration Documentation

Enum TCoeEvent

Observer event types.

EnumeratorValueDescription
EEventRequestExit

Request exit. This event is used to indicate exit from a mode when the user has completed an operation 'successfully'. For example, this event might be sent when the user has a choice list open and presses enter to select an item. The UI Control Framework does not use this event itself.

EEventRequestCancel

Request cancel. This event is used to indicate exit from a mode when the user has cancelled the operation that caused entry into the mode originally. For example, this event might be sent when the user presses escape to close the list and leave the choice as it was. The UI Control Framework does not use this event itself.

EEventRequestFocus

Request focus. This event is notified by the UI Control Framework during pointer down event processing after EEventPrepareFocusTransition is handled.

EEventPrepareFocusTransition

Prepare focus transition. This event is notified by the UI Control Framework during pointer down event processing if the control does not yet have, but could get, focus.

EEventStateChanged

State changed. This event can be used by a control to report that some piece of internal data has changed, and hence that any observer should be notified accordingly. The UI Control Framework does not use this value itself.

EEventInteractionRefused

Interaction refused. This event is notified by the UI Control Framework during pointer down event processing if the control is dimmed (disabled).

Constructor & Destructor Documentation

MCoeControlObserver ( )

IMPORT_CMCoeControlObserver()[protected]

Member Function Documentation

HandleControlEventL ( CCoeControl *, TCoeEvent )

voidHandleControlEventL(CCoeControl *aControl,
TCoeEventaEventType
)[pure virtual]

Handles an event from an observed control.

This function is called when a control for which this control is the observer calls CCoeControl::ReportEventL(). It should be implemented by the observer control, and should handle all events sent by controls it observes.

ParameterDescription
aControlThe control that sent the event.
aEventTypeThe event type.