MHuiVisualOwner Class Reference

class MHuiVisualOwner

Interface for visual owners. A class that owns a visual must implement this interface. Visual owners are expected to destroy their visuals when the owner is destroyed.

Constructor & Destructor Documentation

~MHuiVisualOwner()

IMPORT_C~MHuiVisualOwner()[virtual]

Member Functions Documentation

AppendL(CHuiVisual *)

voidAppendL(CHuiVisual *aVisual)[pure virtual]

Appends a visual to the visual owner.

Parameters

CHuiVisual * aVisualVisual to append. The owner receives ownership of the visual.

ControlGroup()

CHuiControlGroup *ControlGroup()const [pure virtual]

Determines the control group in which the owner belong to. If the owner does not belong to a control group, NULL is returned.

Env()

CHuiEnv &Env()const [pure virtual]

Returns the environment where this visual belongs into.

EventHandler()

MHuiEventHandler *EventHandler()[pure virtual]

Returns the event handler resposible for handling events related to the visual, for example when the visual receives a pointer down event.

Remove(CHuiVisual *)

voidRemove(CHuiVisual *aVisual)[pure virtual]

Removes a visual from the owner.

Parameters

CHuiVisual * aVisualVisual to remove.

VisualDestroyed(CHuiVisual &)

voidVisualDestroyed(CHuiVisual &aVisual)[pure virtual]

Removes a visual from the ownership of the owner. This is called when the visual is being destroyed.

Parameters

CHuiVisual & aVisualVisual to remove.

VisualLayoutUpdated(CHuiVisual &)

voidVisualLayoutUpdated(CHuiVisual &aVisual)[pure virtual]

Notifies the owner that the layout of a visual has been recalculated. Called only when the EHuiVisualFlagLayoutUpdateNotification flag has been set for the visual.

Parameters

CHuiVisual & aVisualVisual that has been laid out.

VisualPrepareDrawFailed(CHuiVisual &, TInt)

voidVisualPrepareDrawFailed(CHuiVisual &aVisual,
TIntaErrorCode
)[pure virtual]

Notifies the visual owner if there was an error (a leave happened) when preparing the visual for drawing. Typically the resource alloc errors such as out of memory is escalated through this callback.

Parameters

CHuiVisual & aVisualVisual that caused the error.
TInt aErrorCodeSymbian KErr error code for the failure.