MCoeControlContext Class Reference

class MCoeControlContext

Interface to allow sharing of graphics settings between controls.

The interface provides functions to set the graphics context of a control before drawing. If a control has its iContext member set, the UI Control Framework calls functions defined by this interface when a control is about to be drawn. Developers must implement PrepareContext(), which is called by the framework, to initialise the control's window with the required graphics settings.

To use control contexts, a control should inherit from an MCoeControlContext-derived class. To share the context between controls, this control should then be set as the context for all controls that wish to share it. This is done by setting the iContext member of each of the controls, using CCoeControl::SetControlContext() and CCoeControl::CopyControlContextFrom().

Public Member Functions
IMPORT_C voidActivateContext(CWindowGc &, RDrawableWindow &)
IMPORT_C voidPrepareContext(CWindowGc &)
IMPORT_C voidResetContext(CWindowGc &)
Protected Member Functions
Private Member Functions
IMPORT_C voidMCoeControlContext_Reserved1()
IMPORT_C voidMCoeControlContext_Reserved2()
Private Attributes
TInt iMCoeControlContext_Reserved1

Constructor & Destructor Documentation



Member Functions Documentation

ActivateContext(CWindowGc &, RDrawableWindow &)

IMPORT_C voidActivateContext(CWindowGc &aGc,
RDrawableWindow &aWindow
)const [virtual]

Activates a graphics context for the specified window.

This function is called whenever a control is about to be drawn. Its default implementation activates the graphics context given by aGc for the window given by aWindow, and calls PrepareContext().

This function may be overridden by derived classes.


CWindowGc & aGcThe graphics context to activate. When called from CCoeControl::ActivateGc(), this is the system graphics context.
RDrawableWindow & aWindowThe window for which the graphics context is to be activated.


IMPORT_C voidMCoeControlContext_Reserved1()[private, virtual]


IMPORT_C voidMCoeControlContext_Reserved2()[private, virtual]

PrepareContext(CWindowGc &)

IMPORT_C voidPrepareContext(CWindowGc &aGc)const [virtual]

Initialises graphics context settings.

This function should be implemented by derived classes to initialise the graphics context, given by aGc, with the required settings. The default implementation is empty.


CWindowGc & aGcThe graphics context to be initialised.

ResetContext(CWindowGc &)

IMPORT_C voidResetContext(CWindowGc &aGc)const [virtual]

Resets the control context.

The default implementation first resets the graphics context given by aGc, and then calls PrepareContext(). The function may be overridden by derived classes.


CWindowGc & aGcThe graphics context to be reset.

Member Data Documentation

TInt iMCoeControlContext_Reserved1

TInt iMCoeControlContext_Reserved1[private]