Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

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

 » Symbian OS v6.1 Edition for C++ » API Reference » UI Control Framework » MCoeControlObserver

Location: coecobs.h
Link against: N/A

Class MCoeControlObserver

MCoeControlObserver

Support

Supported from 5.0

Description

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

Defined in MCoeControlObserver:
EEventInteractionRefused, EEventPrepareFocusTransition, EEventRequestCancel, EEventRequestExit, EEventRequestFocus, EEventStateChanged, HandleControlEventL(), TCoeEvent

Member functions

HandleControlEventL()

virtual void HandleControlEventL(CCoeControl* aControl,TCoeEvent aEventType)=0;

Description

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.

Parameters

CCoeControl* aControl

The control that sent the event.
TCoeEvent aEventType

The event type.

[Top]

Enumerations

Enum TCoeEvent

TCoeEvent

Description

Observer event types.

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).

Copyright ©2002  Symbian Ltd.       6.1-00174

[Top]