CHuiVisual Class Reference

class CHuiVisual : public CBase

Visuals are graphical entities visible on a display. They are responsible for maintaining their state independently.

Visuals use a hierarchical coordinate system. All coordinate values are specified in the base unit of the parent layout, relative to the parent visual's upper left corner. This is called the local coordinate system of the visual. Visuals that have no parent are relative to the upper left corner of the HuiDisplay.

In practice, this means that when a layout is moved 10 pixels to the right, all of its children are automatically also moved 10 pixels to the right on the screen.

Visuals can be tagged with human-readable descriptors. SetTagL()Note that all layouts are derived from CHuiVisual. Layout visuals are used for building visual trees. CHuiLayout

Inherits from

Nested Classes and Structures

Public Member Functions
CHuiVisual(MHuiVisualOwner &)
~CHuiVisual()
IMPORT_C CHuiVisual *AddNewL(CHuiControl &, CHuiLayout *)
IMPORT_C voidAlignByOrigin(THuiRealPoint &, TBool)
IMPORT_C voidBoxMetricToPixelRect(const THuiBoxMetric &, THuiRealRect &)
IMPORT_C voidBoxMetricToPixelRect(const THuiBoxMetric &, THuiRealRect &, THuiReferenceState)
IMPORT_C TReal32BrushOpacity()
IMPORT_C THuiRealRectBrushRect()
IMPORT_C CHuiSkin &BrushSkin()
IMPORT_C CHuiBrushArray *Brushes()
CHuiBrushArray *Brushes()
THuiRealRectCachedDisplayRect()
IMPORT_C TBoolChanged()
IMPORT_C voidClearChanged()
IMPORT_C voidClearFlag(THuiVisualFlags)
IMPORT_C voidClearFlags(TInt)
IMPORT_C TBoolClipping()
IMPORT_C voidConstructL()
IMPORT_C TIntCount()
IMPORT_C CHuiDisplay *Display()
IMPORT_C THuiRealRectDisplayRect()
IMPORT_C THuiRealRectDisplayRectTarget()
IMPORT_C TPointDisplayToLocal(const TPoint &)
IMPORT_C THuiRealPointDisplayToLocal(const THuiRealPoint &)
IMPORT_C voidDraw(CHuiGc &)
IMPORT_C voidDrawBrushes(CHuiGc &, THuiBrushLayer)
IMPORT_C voidDrawSelf(CHuiGc &, const TRect &)
IMPORT_C CHuiDropShadow *DropShadowHandler()
IMPORT_C voidDumpTree()
IMPORT_C CHuiFxEffect *Effect()
IMPORT_C MHuiEffectable *Effectable()
IMPORT_C TReal32EffectiveOpacity()
IMPORT_C voidEnableBrushesL(TBool)
IMPORT_C voidEnableDropShadowL(TBool)
IMPORT_C voidEnableTransformationL(TBool)
IMPORT_C voidEnterLocalProjection(CHuiGc &, TBool, TReal32, const THuiRealRect *)
IMPORT_C CHuiEnv &Env()
TInt FindTacticon(TInt)
IMPORT_C CHuiVisual *FindTag(const TDesC8 &)
TInt Flags()
IMPORT_C TBoolFreezed()
IMPORT_C voidGetClassName(TDes &)
IMPORT_C voidGetDualAlpha(TReal32, TReal32, TInt &, TInt &)
IMPORT_C voidGetInstanceName(TDes &)
IMPORT_C TBoolHasTactileFeedback(TInt)
IMPORT_C THuiVisualHOriginHorizontalOrigin()
IMPORT_C TBoolIsTagged()
IMPORT_C CHuiLayout *Layout()
TBool LoadingEffect()
IMPORT_C THuiXYMetricLocalBaseUnit()
IMPORT_C THuiRealPointLocalPointInPixels(const THuiRealPoint &)
IMPORT_C THuiRealPointLocalPointInPixels(const THuiRealPoint &, THuiReferenceState)
IMPORT_C TPointLocalToDisplay(const TPoint &)
IMPORT_C THuiRealPointLocalToDisplay(const THuiRealPoint &)
IMPORT_C TSizeMaxSize()
IMPORT_C THuiRealSizeMaxSizeInBaseUnits()
IMPORT_C THuiRealPointMetricReferenceInPixels(const THuiXYMetric &)
IMPORT_C THuiRealPointMetricReferenceInPixels(const THuiXYMetric &, THuiReferenceState)
IMPORT_C THuiRealPointMetricToPixels(const THuiXYMetric &)
IMPORT_C THuiRealPointMetricToPixels(const THuiXYMetric &, THuiReferenceState)
IMPORT_C voidMimic(const CHuiVisual &, TInt)
IMPORT_C TSizeMinSize()
IMPORT_C THuiRealSizeMinSizeInBaseUnits()
IMPORT_C voidMove(const TPoint &, TInt)
IMPORT_C voidMove(const THuiRealPoint &, TInt)
IMPORT_C voidMoveToFront(TInt)
IMPORT_C voidNotifySkinChangedL()
IMPORT_C MHuiVisualOwner &Owner()
IMPORT_C const THuiBoxMetric &Padding()
IMPORT_C THuiRealRectPaddingInPixels()
IMPORT_C THuiRealRectPaddingInPixels(THuiReferenceState)
IMPORT_C THuiRealPointPixelPointInLocal(const THuiRealPoint &)
IMPORT_C THuiRealPointPixelPointInLocal(const THuiRealPoint &, THuiReferenceState)
THuiRealPoint PixelPointInUnits(const THuiRealPoint &, const THuiXYMetric &, THuiReferenceState)
IMPORT_C voidPixelsToMetric(const THuiRealPoint &, THuiXYMetric &)
IMPORT_C voidPixelsToMetric(const THuiRealPoint &, THuiXYMetric &, THuiReferenceState)
IMPORT_C const THuiTimedPoint &Pos()
THuiTimedPoint &Pos()
IMPORT_C TBoolPrepareDrawL()
TInt QueryCanvasFlags()
TBool QueryExternalContentDrawingEnabled()
TBool QueryHasDrawableContent()
IMPORT_C voidRemoveAndDestroyAllD()
IMPORT_C voidRemoveTactileFeedback(TInt)
IMPORT_C voidReportChanged()
voidReportLayoutUpdate()
IMPORT_C TIntSessionId()
IMPORT_C voidSetCenteredPosAndSize(const TPoint &, const TSize &, TInt)
IMPORT_C voidSetCenteredPosAndSize(const THuiRealPoint &, const THuiRealSize &, TInt)
IMPORT_C voidSetChanged()
IMPORT_C voidSetClipping(TBool)
voidSetDisplay(CHuiDisplay *)
IMPORT_C voidSetEffect(CHuiFxEffect *)
voidSetEffectParser(CHuiFxEffectParser *)
IMPORT_C voidSetFlag(THuiVisualFlags)
IMPORT_C voidSetFlags(TInt)
IMPORT_C voidSetFreezeState(TBool)
voidSetLayout(CHuiLayout *)
voidSetLoadingEffect(TBool)
IMPORT_C voidSetMaxSize(const TSize &)
IMPORT_C voidSetMaxSize(const THuiRealSize &)
IMPORT_C voidSetMinSize(const TSize &)
IMPORT_C voidSetMinSize(const THuiRealSize &)
IMPORT_C voidSetOrigin(THuiVisualHOrigin, THuiVisualVOrigin)
IMPORT_C voidSetOwner(MHuiVisualOwner &)
IMPORT_C voidSetPadding(TInt)
IMPORT_C voidSetPadding(const TPoint &)
IMPORT_C voidSetPadding(const THuiBoxMetric &)
IMPORT_C voidSetPos(const THuiRealPoint &, TInt)
IMPORT_C voidSetRect(const THuiRealRect &, TInt)
IMPORT_C voidSetSessionId(TInt)
IMPORT_C voidSetSize(const THuiRealSize &, TInt)
IMPORT_C voidSetStoredRenderBuffer(CHuiCanvasRenderBuffer *)
IMPORT_C voidSetStoredRenderBufferModificationsEnabled(TBool)
IMPORT_C voidSetTactileFeedbackL(TInt, TInt)
IMPORT_C voidSetTagL(const TDesC8 &)
voidSetTracking(TBool)
IMPORT_C const THuiTimedPoint &Size()
THuiTimedPoint &Size()
IMPORT_C CHuiSkin &Skin()
IMPORT_C CHuiCanvasRenderBuffer *StoredRenderBuffer()
TInt TactileFeedback(TInt)
IMPORT_C const TDesC8 &Tag()
TBool Tracking()
IMPORT_C CHuiTransformation &Transformation()
IMPORT_C TTypeType()
IMPORT_C voidUpdateChildrenLayout(TInt)
IMPORT_C voidUpdateSiblingLayout(TInt)
IMPORT_C THuiVisualVOriginVerticalOrigin()
IMPORT_C CHuiVisual &Visual(TInt)
Protected Member Functions
voidApplyMirroring(THuiRealPoint &, THuiReferenceState)
voidConvertMetricLengthToPixels(TReal32 &, const THuiMetric &, TReal32)
voidConvertPixelsToMetricLength(THuiMetric &, TReal32, TReal32)
IMPORT_C voidExpandRectWithContent(TRect &)
TBool IsDelayedEffectSource()
IMPORT_C voidTransform(CHuiGc &, TBool, const THuiRealRect *)
IMPORT_C voidVisualExtension(const TUid &, TAny **)
Private Member Functions
THuiRealPoint DisplayToLocal(const THuiRealPoint &, THuiReferenceState)
voidHandleFlagsChanged(TInt)
TBool IsTransformed()
THuiRealPoint LocalToDisplay(const THuiRealPoint &, THuiReferenceState)
TBool ParentChanged()
CHuiTransformation *Transformation()
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Public Attributes
THuiTimedValue iDepthOffset
THuiTimedValue iOpacity
Protected Attributes
MHuiVisualOwner *iOwner
TRect iPreviousDrawn
TInt iSessionId
TBool iTrackVisual
Private Attributes
CHuiBrushArray *iBrushes
CHuiDisplay *iDisplay
THuiRealRectiDisplayRect
TUint iDisplayRectFrameNumber
THuiRealRectiDisplayRectTarget
TUint iDisplayRectTargetFrameNumber
TInt iFlags
CHuiLayout *iLayout
TBool iLoadingEffect
THuiRealSize iMaxSize
THuiRealSize iMinSize
THuiBoxMetric iPadding
THuiTimedPoint iPos
THuiTimedPoint iSize
HBufC8 *iTag
CHuiTransformation *iTransform
THuiVisualPrivateData *iVisualData

Constructor & Destructor Documentation

CHuiVisual(MHuiVisualOwner &)

IMPORT_CCHuiVisual(MHuiVisualOwner &aOwner)

Constructor.

Parameters

MHuiVisualOwner & aOwnerOwner control.

~CHuiVisual()

IMPORT_C~CHuiVisual()

Destructor.

Member Functions Documentation

AddNewL(CHuiControl &, CHuiLayout *)

IMPORT_C CHuiVisual *AddNewL(CHuiControl &aOwnerControl,
CHuiLayout *aParentLayout = 0
)[static]

Constructs and appends a new visual to the owner control.

Parameters

CHuiControl & aOwnerControlControl that will own the new visual.
CHuiLayout * aParentLayout = 0

AlignByOrigin(THuiRealPoint &, TBool)

IMPORT_C voidAlignByOrigin(THuiRealPoint &aPoint,
TBoolaUndo = EFalse
)const

Moves a point according to the visual's origin position. If this is called on both the iTl and iBr corners of a rectangle, the result is that the rectangle is aligned by the origin. This method is used during the calculations to determine a visual's display rectangle.

Parameters

THuiRealPoint & aPointPoint to move.
TBool aUndo = EFalseWhich way to offset the point (apply or undo the alignment).

ApplyMirroring(THuiRealPoint &, THuiReferenceState)

voidApplyMirroring(THuiRealPoint &aPixels,
THuiReferenceStateaReferenceState
)const [protected]

Applies mirroring to a coordinate point according to the base unit of the local coordinate system.

Parameters

THuiRealPoint & aPixelsPoint to mirror in pixels. The mirrored result is returned here.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

BoxMetricToPixelRect(const THuiBoxMetric &, THuiRealRect &)

IMPORT_C voidBoxMetricToPixelRect(const THuiBoxMetric &aBox,
THuiRealRect &aRectInPixels
)const

Parameters

const THuiBoxMetric & aBox
THuiRealRect & aRectInPixels

BoxMetricToPixelRect(const THuiBoxMetric &, THuiRealRect &, THuiReferenceState)

IMPORT_C voidBoxMetricToPixelRect(const THuiBoxMetric &aBox,
THuiRealRect &aRectInPixels,
THuiReferenceStateaReferenceState
)const

Converts a box metric to a pixel rectangle. This method is used for converting visual padding boxes to pixels.

Parameters

const THuiBoxMetric & aBoxBox metric to be interpreted in the context of this visual.
THuiRealRect & aRectInPixelsResulting rectangle in pixels. Note that the width and height of this box are meaningless, because each of the four sides is defined independently of each other.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

BrushOpacity()

IMPORT_C TReal32BrushOpacity()const

BrushRect()

IMPORT_C THuiRealRectBrushRect()const

BrushSkin()

IMPORT_C CHuiSkin &BrushSkin()const

Brushes()

IMPORT_C CHuiBrushArray *Brushes()

Returns the brushes of the visual.

Brushes()

CHuiBrushArray *Brushes()const

Returns the brushes of the visual.

CachedDisplayRect()

THuiRealRectCachedDisplayRect()const

Gets the visual's bounding rectangle in display coordinates that were calculated during previous frame. Display coordinates are defined relative to the display's visible area. Uses the current values of the position and size. Only calculated once per frame. The rect is always in pixels.

Changed()

IMPORT_C TBoolChanged()const [virtual]

Determines if the visual has changed since the last change notification. Changed means becoming dirty, so that the area of the visual has to be redrawn.

ClearChanged()

IMPORT_C voidClearChanged()[virtual]

Clears the changed status of the visual. This is called automatically by the refresh loop after a frame has been drawn.

ClearFlag(THuiVisualFlags)

IMPORT_C voidClearFlag(THuiVisualFlagsaFlag)

Unset flags that affect the visual's behaviour.

Parameters

THuiVisualFlags aFlagFlag to clear.

ClearFlags(TInt)

IMPORT_C voidClearFlags(TIntaAnyFlags)

Clear one or more flags that affect the visual's behaviour.

Parameters

TInt aAnyFlagsOne or more flags to clear.

Clipping()

IMPORT_C TBoolClipping()const

Determines whether the visual is clipping its contents.

ConstructL()

IMPORT_C voidConstructL()[virtual]

Second-phase constructor, must be called in deriving class.

ConvertMetricLengthToPixels(TReal32 &, const THuiMetric &, TReal32)

voidConvertMetricLengthToPixels(TReal32 &aResult,
const THuiMetric &aMetric,
TReal32aReference
)[protected, static]

Parameters

TReal32 & aResult
const THuiMetric & aMetric
TReal32 aReference

ConvertPixelsToMetricLength(THuiMetric &, TReal32, TReal32)

voidConvertPixelsToMetricLength(THuiMetric &aResult,
TReal32aPixels,
TReal32aReference
)[protected, static]

Parameters

THuiMetric & aResult
TReal32 aPixels
TReal32 aReference

Count()

IMPORT_C TIntCount()const [virtual]

Returns the number of child visuals.

Display()

IMPORT_C CHuiDisplay *Display()const

Returns the display of the visual (if shown).

DisplayRect()

IMPORT_C THuiRealRectDisplayRect()const

Calculates the visual's bounding rectangle in display coordinates. Display coordinates are defined relative to the display's visible area. Uses the current values of the position and size. Only calculated once per frame. The rect is always in pixels.

DisplayRectTarget()

IMPORT_C THuiRealRectDisplayRectTarget()const

Calculates the visual's bounding rectangle animation target in display coordinates. Display coordinates are defined relative to the display's visible area. Uses the target values of the rectangle position and size, which means transitions are always immediate in the returned rectangle. Only calculated once per frame. The rect is always in pixels.

DisplayToLocal(const TPoint &)

IMPORT_C TPointDisplayToLocal(const TPoint &aPoint)const

Converts display coordinates to local coordinates. This method can be used when determining where a particular point on the display is in the local coordinate system of a layout, for instance when handling pointer input events. Display coordinates are defined relative to the display's visible area.

Parameters

const TPoint & aPointPoint in the display coordinate system.

DisplayToLocal(const THuiRealPoint &)

IMPORT_C THuiRealPointDisplayToLocal(const THuiRealPoint &aPoint)const

Converts display coordinates to local coordinates. This method can be used when determining where a particular point on the display is in the local coordinate system of a layout, for instance when handling pointer input events. Display coordinates are defined relative to the display's visible area.

Parameters

const THuiRealPoint & aPointPoint in the display coordinate system.

DisplayToLocal(const THuiRealPoint &, THuiReferenceState)

THuiRealPoint DisplayToLocal(const THuiRealPoint &aPoint,
THuiReferenceStateaReferenceState
)const [private]

Converts display coordinates to local coordinates. This method can be used when determining where a particular point on the display is in the local coordinate system of a layout, for instance when handling pointer input events. Display coordinates are defined relative to the display's visible area.

Parameters

const THuiRealPoint & aPointPoint in the display coordinate system.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

Draw(CHuiGc &)

IMPORT_C voidDraw(CHuiGc &aGc)const [virtual]

Draws the visual.

This default implementation applies local transformation, draws foreground brushes (over the content), background brushes (under the content) and content itself (by calling DrawSelf()) with clipping.

Note:

DrawSelf() should bee overridden by subclasses to draw the content of the visual.

DrawSelf() PrepareDrawL()

Parameters

CHuiGc & aGc

DrawBrushes(CHuiGc &, THuiBrushLayer)

IMPORT_C voidDrawBrushes(CHuiGc &aGc,
THuiBrushLayeraLayer
)const

Draws a layer of brushes for the visual.

Parameters

CHuiGc & aGcGraphics context.
THuiBrushLayer aLayerBrush layer.

DrawSelf(CHuiGc &, const TRect &)

IMPORT_C voidDrawSelf(CHuiGc &aGc,
const TRect &aDisplayRect
)const [virtual]

Overridden by subclasses to draw the content of the visual. By default the base class DrawSelf does not draw anything.

Note:

DrawSelf won't be called for fully transparent visuals.

Draw() PrepareDrawL()

Parameters

CHuiGc & aGcThe graphics context to be used to draw the visual.
const TRect & aDisplayRectThe bounding rectangle of the visual content, in display coordinates. Same as calling CHuiVisual::DisplayRect().

DropShadowHandler()

IMPORT_C CHuiDropShadow *DropShadowHandler()const

Returns the drop shadow parameter handler.

DumpTree()

IMPORT_C voidDumpTree()const [virtual]

Debug method for dumping the structure of a visual tree into the console.

Effect()

IMPORT_C CHuiFxEffect *Effect()const

Returns the currently active effect for the visual or NULL if no effect is active.

Effectable()

IMPORT_C MHuiEffectable *Effectable()const

EffectiveOpacity()

IMPORT_C TReal32EffectiveOpacity()const

Returns the opacity of the visual, taking into account the opacity of parent visuals.

EnableBrushesL(TBool)

IMPORT_C voidEnableBrushesL(TBoolaEnabled = ETrue)

Enables or disables brushes for the visual.

Parameters

TBool aEnabled = ETrue

EnableDropShadowL(TBool)

IMPORT_C voidEnableDropShadowL(TBoolaEnable = ETrue)

Enables the drop shadow. Currently implemented for the image and text visuals.

Parameters

TBool aEnable = ETrueETrue to enable, EFalse to disable.

EnableTransformationL(TBool)

IMPORT_C voidEnableTransformationL(TBoolaIsTransformed = ETrue)

Enables or disables transformation of the visual.

Parameters

TBool aIsTransformed = ETrue

EnterLocalProjection(CHuiGc &, TBool, TReal32, const THuiRealRect *)

IMPORT_C voidEnterLocalProjection(CHuiGc &aGc,
TBoolaApply,
TReal32aExtraOffset = 0.0,
const THuiRealRect *aVisibleRect = 0
)const

Applies or restores the local projection of the visual.

Parameters

CHuiGc & aGc
TBool aApply
TReal32 aExtraOffset = 0.0
const THuiRealRect * aVisibleRect = 0

Env()

IMPORT_C CHuiEnv &Env()const

Returns the environment of the visual.

ExpandRectWithContent(TRect &)

IMPORT_C voidExpandRectWithContent(TRect &aRect)const [protected, virtual]

Expands the dirty region of the visual depending on the content of the visual. This includes any brushes attached to the visual. Used during dirty region reporting.

Parameters

TRect & aRectDirty region.

FindTacticon(TInt)

TInt FindTacticon(TIntaEventType)const

Finds a tacticon from this visual.

Parameters

TInt aEventTypeEvent type to match

FindTag(const TDesC8 &)

IMPORT_C CHuiVisual *FindTag(const TDesC8 &aTag)[virtual]

Finds a visual whose tag descriptor contains a specific tag.

CHuiVisual::FindTag() is the basic implementation that checks if this visual's tag matches the specified tag. CHuiLayout::FindTag() extends the search into child visuals, covering recursively entire visual hierarchies.

CHuiVisual::Tag() CHuiVisual::SetTagL() CHuiVisual::IsTagged() CHuiLayout::FindTag()

Parameters

const TDesC8 & aTagTag to look for. If this tag is found as a part of a visual's colon-separated tag descriptor, it is treated as a match and the visual is returned. The tag to look for cannot contain separator characters (:).

Flags()

TInt Flags()const [inline]

Returns the flags of the visual.

Freezed()

IMPORT_C TBoolFreezed()const

GetClassName(TDes &)

IMPORT_C voidGetClassName(TDes &aName)const [virtual]

Returns the name of the class.

Parameters

TDes & aNameName of the visual class.

GetDualAlpha(TReal32, TReal32, TInt &, TInt &)

IMPORT_C voidGetDualAlpha(TReal32aOpacity,
TReal32aSecondary,
TInt &aPrimaryAlpha,
TInt &aSecondaryAlpha
)[static]

Calculate dual alpha levels. Used when crossfading images.

Parameters

TReal32 aOpacity
TReal32 aSecondary
TInt & aPrimaryAlpha
TInt & aSecondaryAlpha

GetInstanceName(TDes &)

IMPORT_C voidGetInstanceName(TDes &aName)const [virtual]

Parameters

TDes & aName

HandleFlagsChanged(TInt)

voidHandleFlagsChanged(TIntaOldFlags)[private]

Handle flags changes.

Parameters

TInt aOldFlagsflags previous to the changes.

HasTactileFeedback(TInt)

IMPORT_C TBoolHasTactileFeedback(TIntaEventType =  KHuiTactileFeedbackEventTypeNone )const

Checks whether a tactile feedback has been assigned. Eventhough, this returns EFalse the layout may have feedback defined.

Parameters

TInt aEventType =  KHuiTactileFeedbackEventTypeNone Event type which needs to match If KHuiTactileFeedbackEventTypeNone, the event type is irrelevant.

HorizontalOrigin()

IMPORT_C THuiVisualHOriginHorizontalOrigin()const

Determines the horizontal origin.

IsDelayedEffectSource()

TBool IsDelayedEffectSource()const [protected]

IsTagged()

IMPORT_C TBoolIsTagged()const

Determines if the visual has a tag.

CHuiVisual::Tag() CHuiVisual::SetTagL() CHuiVisual::FindTag()

IsTransformed()

TBool IsTransformed()const [private]

Checks if this visual is transformed.

Layout()

IMPORT_C CHuiLayout *Layout()const

Returns the layout this visual belongs to.

LoadingEffect()

TBool LoadingEffect()const [inline]

LocalBaseUnit()

IMPORT_C THuiXYMetricLocalBaseUnit()const

Determines the base unit of the local coordinate system, in which this visual's position and size are stored. The position and size of the visual are multiplied by this metric to get the actual position and size.

LocalPointInPixels(const THuiRealPoint &)

IMPORT_C THuiRealPointLocalPointInPixels(const THuiRealPoint &aLocalPoint)const

! deprecated, use method with THuiReferenceState instead

Parameters

const THuiRealPoint & aLocalPoint

LocalPointInPixels(const THuiRealPoint &, THuiReferenceState)

IMPORT_C THuiRealPointLocalPointInPixels(const THuiRealPoint &aLocalPoint,
THuiReferenceStateaReferenceState
)const

Converts a point in the local coordinate system to pixels in the local coordinate system. The local coordinate system is relative to the top left corner of the parent. This method only does a unit conversion from the base units to pixels.

Parameters

const THuiRealPoint & aLocalPointPoint to convert, which is using the local base unit.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

LocalToDisplay(const TPoint &)

IMPORT_C TPointLocalToDisplay(const TPoint &aPoint)const

Converts local coordinates to display coordinates. This method is used for calculating the position of the visual on the display when the visual is about to be drawn. Display coordinates are defined relative to the display's visible area.

Parameters

const TPoint & aPointPoint in the local coordinate system. This might be, for example, the position or size of this visual.

LocalToDisplay(const THuiRealPoint &)

IMPORT_C THuiRealPointLocalToDisplay(const THuiRealPoint &aPoint)const

Converts local coordinates to display coordinates. This method is used for calculating the position of the visual on the display when the visual is about to be drawn. Display coordinates are defined relative to the display's visible area.

Parameters

const THuiRealPoint & aPointPoint in the local coordinate system. This might be, for example, the position or size of this visual.

LocalToDisplay(const THuiRealPoint &, THuiReferenceState)

THuiRealPoint LocalToDisplay(const THuiRealPoint &aPoint,
THuiReferenceStateaReferenceState
)const [private]

Converts local coordinates to display coordinates. This method is used for calculating the position of the visual on the display when the visual is about to be drawn. Display coordinates are defined relative to the display's visible area.

Parameters

const THuiRealPoint & aPointPoint in the local coordinate system. This might be, for example, the position or size of this visual.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

MaxSize()

IMPORT_C TSizeMaxSize()const

Use base unit version instead

Returns the maximum size of the visual.

MaxSizeInBaseUnits()

IMPORT_C THuiRealSizeMaxSizeInBaseUnits()const

Returns the maximum size of the visual in base units.

MetricReferenceInPixels(const THuiXYMetric &)

IMPORT_C THuiRealPointMetricReferenceInPixels(const THuiXYMetric &aMetric)const

! deprecated, use method with THuiReferenceState instead

Parameters

const THuiXYMetric & aMetric

MetricReferenceInPixels(const THuiXYMetric &, THuiReferenceState)

IMPORT_C THuiRealPointMetricReferenceInPixels(const THuiXYMetric &aMetric,
THuiReferenceStateaReferenceState
)const

Calculates the reference size for a metric. The reference size is, for example, the size of the parent layout in the case of the EHuiUnitNormalized unit.

Parameters

const THuiXYMetric & aMetricMetric whose reference size is to be determined.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

MetricToPixels(const THuiXYMetric &)

IMPORT_C THuiRealPointMetricToPixels(const THuiXYMetric &aMetric)const

! deprecated, use method with THuiReferenceState instead

Parameters

const THuiXYMetric & aMetric

MetricToPixels(const THuiXYMetric &, THuiReferenceState)

IMPORT_C THuiRealPointMetricToPixels(const THuiXYMetric &aMetric,
THuiReferenceStateaReferenceState
)const

Converts an XY metric to a pixel point.

Parameters

const THuiXYMetric & aMetricMetric to convert.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

Mimic(const CHuiVisual &, TInt)

IMPORT_C voidMimic(const CHuiVisual &aVisual,
TIntaTransitionTime = 0
)

Positions and sizes this visual to match another.

This method should be used only when doing manual layouting. If the visuals are under a layout, then the layout class's facilities should be used instead.

If you want to move or otherwise layout the visual manually, you should set the EHuiVisualFlagManualLayout flag using SetFlag() method.

Note:

Even if the visual has no parent -- the roster will automatically lay it out to cover the entire display, so the EHuiVisualFlagManualLayout will be needed if you want to mimic other visuals.

Parameters

const CHuiVisual & aVisualVisual whose position and size to copy.
TInt aTransitionTime = 0

MinSize()

IMPORT_C TSizeMinSize()const

Use base unit version instead

Returns the minimum size of the visual.

MinSizeInBaseUnits()

IMPORT_C THuiRealSizeMinSizeInBaseUnits()const

Returns the minimum size of the visual in base units.

Move(const TPoint &, TInt)

IMPORT_C voidMove(const TPoint &aOffset,
TIntaTransitionTime = 0
)

Use base unit version instead

Moves the visual's position.

Move() should be used only when doing manual layouting (same goes for SetPos() and SetSize()). If the visuals are under a layout that defines positions for its children (such as CHuiGridLayout), then the layout class's facilities should be used instead.

If you want to move or otherwise layout the visual manually, you should set the EHuiVisualFlagManualLayout flag using SetFlag() method.

Note:

Even if the visual has no parent -- the roster will automatically lay it out to cover the entire display, so the EHuiVisualFlagManualLayout will be needed if you want to move this visual.

Parameters

const TPoint & aOffsetOffset from the current target.
TInt aTransitionTime = 0Transition time in milliseconds.

Move(const THuiRealPoint &, TInt)

IMPORT_C voidMove(const THuiRealPoint &aOffset,
TIntaTransitionTime = 0
)

Moves the visual's position.

Move() should be used only when doing manual layouting (same goes for SetPos() and SetSize()). If the visuals are under a layout that defines positions for its children (such as CHuiGridLayout), then the layout class's facilities should be used instead.

If you want to move or otherwise layout the visual manually, you should set the EHuiVisualFlagManualLayout flag using SetFlag() method.

Note:

Even if the visual has no parent -- the roster will automatically lay it out to cover the entire display, so the EHuiVisualFlagManualLayout will be needed if you want to move this visual.

Parameters

const THuiRealPoint & aOffsetOffset from the current target.
TInt aTransitionTime = 0Transition time in milliseconds.

MoveToFront(TInt)

IMPORT_C voidMoveToFront(TIntaTransitionTime = 0)

Converts a box metric to a rectangle in local coordinates. This method is used for converting visual padding boxes to local coordinate units when doing layout.

Parameters

TInt aTransitionTime = 0

NotifySkinChangedL()

IMPORT_C voidNotifySkinChangedL()[virtual]

Notifies the visual that the environment's skin has been changed or updated. The visual should update its state (e.g., fonts) accordingly.

Owner()

IMPORT_C MHuiVisualOwner &Owner()const

Returns the owner of the visual.

Padding()

IMPORT_C const THuiBoxMetric &Padding()const

Returns the padding of the visual.

PaddingInPixels()

IMPORT_C THuiRealRectPaddingInPixels()const

! deprecated, use method with THuiReferenceState instead

PaddingInPixels(THuiReferenceState)

IMPORT_C THuiRealRectPaddingInPixels(THuiReferenceStateaReferenceState)const

Returns the padding of the visual, in pixels.

Parameters

THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

ParentChanged()

TBool ParentChanged()const [private]

Determines if the visuals parent has changed since the last change notification so that it may require also this visual to report itself as changed.

PixelPointInLocal(const THuiRealPoint &)

IMPORT_C THuiRealPointPixelPointInLocal(const THuiRealPoint &aPixelPoint)const

! deprecated, use method with THuiReferenceState instead

Parameters

const THuiRealPoint & aPixelPoint

PixelPointInLocal(const THuiRealPoint &, THuiReferenceState)

IMPORT_C THuiRealPointPixelPointInLocal(const THuiRealPoint &aPixelPoint,
THuiReferenceStateaReferenceState
)const

Converts a pixel point in the local coordinate system to a point that uses the base unit of the local coordinate system. The local coordinate system is relative to the top left corner of the parent. This method only does a unit conversion from pixels to the base units.

Parameters

const THuiRealPoint & aPixelPointPoint to convert, which is in pixels.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

PixelPointInUnits(const THuiRealPoint &, const THuiXYMetric &, THuiReferenceState)

THuiRealPoint PixelPointInUnits(const THuiRealPoint &aPixelPoint,
const THuiXYMetric &aUnit,
THuiReferenceStateaReferenceState
)const

Converts a pixel point to a specific unit.

Parameters

const THuiRealPoint & aPixelPointPoint to convert, in pixels.
const THuiXYMetric & aUnitUnit to which the point is to be converted.
THuiReferenceState aReferenceStateDefines whether now or target value is used in case there are metrics transformations taking place

PixelsToMetric(const THuiRealPoint &, THuiXYMetric &)

IMPORT_C voidPixelsToMetric(const THuiRealPoint &aPixels,
THuiXYMetric &aMetric
)const

! deprecated, use method with THuiReferenceState instead

Parameters

const THuiRealPoint & aPixels
THuiXYMetric & aMetric

PixelsToMetric(const THuiRealPoint &, THuiXYMetric &, THuiReferenceState)

IMPORT_C voidPixelsToMetric(const THuiRealPoint &aPixels,
THuiXYMetric &aMetric,
THuiReferenceStateaReferenceState
)const

Converts a pixel point to an XY metric. The destination unit of the conversion is taken from the aMetric parameter.

Parameters

const THuiRealPoint & aPixelsPixel point to convert.
THuiXYMetric & aMetricThe result is written here. Only the magnitudes of the metric are modified. The iUnit of the conversion is read from this metric.
THuiReferenceState aReferenceState

Pos()

IMPORT_C const THuiTimedPoint &Pos()const

Returns the position of the visual. This is set by UpdateLayout().

Pos()

THuiTimedPoint &Pos()[inline]

Returns the position of the visual.

PrepareDrawL()

IMPORT_C TBoolPrepareDrawL()[virtual]

PrepareDrawL prepares the visual for drawing (screen refresh). Can be used to update the visual or execute any Leaving operations such as resource allocation needed for the actual drawing.

By default the base class PrepareDrawL does not do anything.

QueryCanvasFlags()

TInt QueryCanvasFlags()

Queries canvas flags of the visual, returns result

QueryExternalContentDrawingEnabled()

TBool QueryExternalContentDrawingEnabled()

Checks if external content drawing is enabled for this visual, returns result

QueryHasDrawableContent()

TBool QueryHasDrawableContent()

Checks if visual has something to draw, returns result

RemoveAndDestroyAllD()

IMPORT_C voidRemoveAndDestroyAllD()[virtual]

Destroys a hierarchy of visuals, along with this visual. The visuals are first removed from their owner.

RemoveTactileFeedback(TInt)

IMPORT_C voidRemoveTactileFeedback(TIntaEventType =  KHuiTactileFeedbackEventTypeNone )

Removes tactile feedback for the visual.

Parameters

TInt aEventType =  KHuiTactileFeedbackEventTypeNone Event type which feedback to remove. If KHuiTactileFeedbackEventTypeNone, all the feedbacks are removed.

ReportChanged()

IMPORT_C voidReportChanged()[virtual]

Called to inform the display that a dirty region has to be defined.

ReportLayoutUpdate()

voidReportLayoutUpdate()

Reports a layout update to the owner. The owner is notified of the layout update if the layout update notification flag is set for the visual.

EHuiVisualFlagLayoutUpdateNotification

SessionId()

IMPORT_C TIntSessionId()const

Gets the session id for object.

SetCenteredPosAndSize(const TPoint &, const TSize &, TInt)

IMPORT_C voidSetCenteredPosAndSize(const TPoint &aCenterPoint,
const TSize &aSize,
TIntaTransitionTime = 0
)

Use base unit version instead

Sets the position and size of the visual.

This method should be used only when doing manual layouting. If the visuals are under a layout, then the layout class's facilities should be used instead.

If you want to move or otherwise layout the visual manually, you should set the EHuiVisualFlagManualLayout flag using SetFlag() method.

Note:

Even if the visual has no parent -- the roster will automatically lay it out to cover the entire display, so the EHuiVisualFlagManualLayout will be needed if you want to assign the position and size yourself.

Parameters

const TPoint & aCenterPointNew center point of the visual.
const TSize & aSizeNew size of the visual.
TInt aTransitionTime = 0Number of milliseconds for transitioning to new values.

SetCenteredPosAndSize(const THuiRealPoint &, const THuiRealSize &, TInt)

IMPORT_C voidSetCenteredPosAndSize(const THuiRealPoint &aCenterPoint,
const THuiRealSize &aSize,
TIntaTransitionTime = 0
)

Sets the position and size of the visual.

This method should be used only when doing manual layouting. If the visuals are under a layout, then the layout class's facilities should be used instead.

If you want to move or otherwise layout the visual manually, you should set the EHuiVisualFlagManualLayout flag using SetFlag() method.

Note:

Even if the visual has no parent -- the roster will automatically lay it out to cover the entire display, so the EHuiVisualFlagManualLayout will be needed if you want to assign the position and size yourself.

Parameters

const THuiRealPoint & aCenterPointNew center point of the visual in metric units.
const THuiRealSize & aSizeNew size of the visual in metric units.
TInt aTransitionTime = 0Number of milliseconds for transitioning to new values.

SetChanged()

IMPORT_C voidSetChanged()[virtual]

Raises the change flag for this visual. Visual will be updated as soon as possible.

SetClipping(TBool)

IMPORT_C voidSetClipping(TBoolaClipping = ETrue)

Sets the clipping mode of the layout.

Parameters

TBool aClipping = ETrueETrue to hide children that are outside the layout's real size.

SetDisplay(CHuiDisplay *)

voidSetDisplay(CHuiDisplay *aDisplay)

Sets the display on which the visual is being shown.

Parameters

CHuiDisplay * aDisplay

SetEffect(CHuiFxEffect *)

IMPORT_C voidSetEffect(CHuiFxEffect *aEffect)

Assign an effect for the visual. The ownership of the effect is transferred to the visual.

Parameters

CHuiFxEffect * aEffectEffect instance.

SetEffectParser(CHuiFxEffectParser *)

voidSetEffectParser(CHuiFxEffectParser *aEffectParser)

Assign the effect parser to the visual. The ownership is transferred to the visual This must be done because the parsing is asynchronous, and we must be sure that the visual is still alive when the parsing completes.

Parameters

CHuiFxEffectParser * aEffectParserEffect parser instance

SetFlag(THuiVisualFlags)

IMPORT_C voidSetFlag(THuiVisualFlagsaFlag)

Set a flag that affects the visual's behaviour.

Parameters

THuiVisualFlags aFlagFlag to set.

SetFlags(TInt)

IMPORT_C voidSetFlags(TIntaAnyFlags)

Sets one or more flags that affect the visual's behaviour.

Parameters

TInt aAnyFlagsOne or more flags to set.

SetFreezeState(TBool)

IMPORT_C voidSetFreezeState(TBoolaEnabled)

Parameters

TBool aEnabled

SetLayout(CHuiLayout *)

voidSetLayout(CHuiLayout *aLayout)

Sets the layout this visual belongs to.

Parameters

CHuiLayout * aLayout

SetLoadingEffect(TBool)

voidSetLoadingEffect(TBoolaLoading)[inline]

Parameters

TBool aLoading

SetMaxSize(const TSize &)

IMPORT_C voidSetMaxSize(const TSize &aMaxSize)

Use base unit version instead

Sets the maximum size of the visual.

Parameters

const TSize & aMaxSizeMaximum size of the visual.

SetMaxSize(const THuiRealSize &)

IMPORT_C voidSetMaxSize(const THuiRealSize &aMaxSize)

Sets the maximum size of the visual.

Parameters

const THuiRealSize & aMaxSizeMaximum size of the visual in base units.

SetMinSize(const TSize &)

IMPORT_C voidSetMinSize(const TSize &aMinSize)

Use base unit version instead

Sets the minimum size of the visual.

Parameters

const TSize & aMinSizeMinimum size of the visual.

SetMinSize(const THuiRealSize &)

IMPORT_C voidSetMinSize(const THuiRealSize &aMinSize)

Sets the minimum size of the visual.

Parameters

const THuiRealSize & aMinSizeMinimum size of the visual in base units.

SetOrigin(THuiVisualHOrigin, THuiVisualVOrigin)

IMPORT_C voidSetOrigin(THuiVisualHOriginaHoriz,
THuiVisualVOriginaVert
)

Sets the origin of the visual. The origin defines the location of the visual's position in relation to its DisplayRect. By default the visual's position defines its top left corner.

Calling this method is equivalent to setting/clearing the corresponding flags.

Parameters

THuiVisualHOrigin aHoriz
THuiVisualVOrigin aVert

SetOwner(MHuiVisualOwner &)

IMPORT_C voidSetOwner(MHuiVisualOwner &aOwner)

Sets the owner of the visual.

Parameters

MHuiVisualOwner & aOwnerNew owner of the visual.

SetPadding(TInt)

IMPORT_C voidSetPadding(TIntaPadding)

Sets the number of pixels that the visual uses for padding its contents. Sets both the horizontal and vertical padding.

Parameters

TInt aPaddingNumber of padding pixels.

SetPadding(const TPoint &)

IMPORT_C voidSetPadding(const TPoint &aPadding)

Sets the number of pixels that the visual uses for padding its contents. Sets the horizontal and vertical padding separately.

Parameters

const TPoint & aPaddingNumber of padding pixels.

SetPadding(const THuiBoxMetric &)

IMPORT_C voidSetPadding(const THuiBoxMetric &aPadding)

Sets the amount of padding that the visual uses for padding its contents. The box metric can have a different amount on all sides.

Note:

as paddings are relative to the visual, if relative units are required for a layout, it is advisable to use EHuiUnitRelativeToMySize so that the paddings are relative to the size of this layout visual

Parameters

const THuiBoxMetric & aPaddingAmount of padding.

SetPos(const THuiRealPoint &, TInt)

IMPORT_C voidSetPos(const THuiRealPoint &aPos,
TIntaTransitionTime = 0
)[virtual]

Sets the position of the visual.

This method should be used only when doing manual layouting. If the visuals are under a layout that defines positions for its children (such as CHuiGridLayout), then the layout class's facilities should be used instead.

If you want to move or otherwise layout the visual manually, you should set the EHuiVisualFlagManualLayout flag using the SetFlag() method.

Note:

Even if the visual has no parent -- the roster will automatically lay it out to cover the entire display, so the EHuiVisualFlagManualLayout will be needed if you want to assign the position yourself.

Parameters

const THuiRealPoint & aPosTarget position, in the local coordinate system as defined by the parent layout (or the display, if there is no parent).
TInt aTransitionTime = 0Transition time in milliseconds.

SetRect(const THuiRealRect &, TInt)

IMPORT_C voidSetRect(const THuiRealRect &aRect,
TIntaTransitionTime = 0
)

Sets the position and size of the visual.

This method should be used only when doing manual layouting. If the visuals are under a layout that defines positions and sizes for its children (such as CHuiGridLayout), then the layout class's facilities should be used instead.

If you want to move or otherwise layout the visual manually, you should set the EHuiVisualFlagManualLayout flag using SetFlag() method.

Note:

Even if the visual has no parent -- the roster will automatically lay it out to cover the entire display, so the EHuiVisualFlagManualLayout will be needed if you want to assign the rectangle yourself.

Parameters

const THuiRealRect & aRectTarget rectangle, in the local coordinate system as defined by the parent layout (or the display, if there is no parent).
TInt aTransitionTime = 0Transition time in milliseconds.

SetSessionId(TInt)

IMPORT_C voidSetSessionId(TIntaSessionId)

Sets the session id for object.

Parameters

TInt aSessionId

SetSize(const THuiRealSize &, TInt)

IMPORT_C voidSetSize(const THuiRealSize &aSize,
TIntaTransitionTime = 0
)[virtual]

Sets the size of the visual.

This method should be used only when doing manual layouting. If the visuals are under a layout that defines sizes for its children (such as CHuiGridLayout), then the layout class's facilities should be used instead.

If you want to move or otherwise layout the visual manually, you should set the EHuiVisualFlagManualLayout flag using SetFlag() method.

Note:

Even if the visual has no parent -- the roster will automatically lay it out to cover the entire display, so the EHuiVisualFlagManualLayout will be needed if you want to assign the size yourself.

Parameters

const THuiRealSize & aSizeNew size for this visual, in the local coordinate system as defined by the parent layout (or the display, if there is no parent).
TInt aTransitionTime = 0Transition time in milliseconds.

SetStoredRenderBuffer(CHuiCanvasRenderBuffer *)

IMPORT_C voidSetStoredRenderBuffer(CHuiCanvasRenderBuffer *aRenderBuffer)

Parameters

CHuiCanvasRenderBuffer * aRenderBuffer

SetStoredRenderBufferModificationsEnabled(TBool)

IMPORT_C voidSetStoredRenderBufferModificationsEnabled(TBoolaEnabled)

Parameters

TBool aEnabled

SetTactileFeedbackL(TInt, TInt)

IMPORT_C voidSetTactileFeedbackL(TIntaEventType,
TIntaFeedbackType
)

Sets an automatic tactile feedback. If this visual is a layout, the feedback affects to the child visuals as well. This can be overridden in child visuals.

TTouchEventType from touchlogicalfeedback.h TTouchLogicalFeedback from touchlogicalfeedback.h

Parameters

TInt aEventTypeEvent which triggers the automatic feedback.
TInt aFeedbackTypeFeedback type.

SetTagL(const TDesC8 &)

IMPORT_C voidSetTagL(const TDesC8 &aTag)

Sets the tag of the visual.

The tag is a descriptor, in the form of one or more colon-separated character sequences. By default, visuals have no tag (""). Normally, a visual could have a single tag, for example ("caption"). The tag descriptor of the visual may contain multiple tags, for example: "tag1:tag2:tag3".

Tags can be used for identifying visuals. In a typical use case, a control could identify which of its visuals represent certain elements of the control based on the tag descriptors. In this case, the tags would be set by an outside party that also sets the tags of the visuals.

CHuiVisual::Tag() CHuiVisual::IsTagged() CHuiVisual::FindTag()

Parameters

const TDesC8 & aTagTag descriptor for the visual.

SetTracking(TBool)

voidSetTracking(TBoolaValue)[inline]

Parameters

TBool aValue

Size()

IMPORT_C const THuiTimedPoint &Size()const

Returns the size of the visual. This is set by UpdateLayout().

Size()

THuiTimedPoint &Size()[inline]

Skin()

IMPORT_C CHuiSkin &Skin()const

Returns the skin of the owner control's environment.

StoredRenderBuffer()

IMPORT_C CHuiCanvasRenderBuffer *StoredRenderBuffer()const

TactileFeedback(TInt)

TInt TactileFeedback(TIntaEventType)const

Return tactile feedback of the event. Checks the parent layouts if this visual has not defined a feedback.

Parameters

TInt aEventTypeEvent type

Tag()

IMPORT_C const TDesC8 &Tag()const

Tracking()

TBool Tracking()const [inline]

Transform(CHuiGc &, TBool, const THuiRealRect *)

IMPORT_C voidTransform(CHuiGc &aGc,
TBoolaApply,
const THuiRealRect *aVisibleRect = 0
)const [protected]

Applies or restores the local transformation matrix of the visual. Should be called before and after drawing the visual.

Parameters

CHuiGc & aGcGraphics context.
TBool aApplyETrue, if the local transformation should be applied; EFalse, if it should be removed.
const THuiRealRect * aVisibleRect = 0

Transformation()

IMPORT_C CHuiTransformation &Transformation()

Returns the transformation of the visual.

panic
THuiPanic::EVisualTransformNotEnabled

Transformation()

CHuiTransformation *Transformation()const [private]

Retruns pointer to transformation if this visual is transformed. Otherwise NULL is returned.

Type()

IMPORT_C TTypeType()const

Gets the object type.

UpdateChildrenLayout(TInt)

IMPORT_C voidUpdateChildrenLayout(TIntaTransitionTime = 0)[virtual]

Update the layout of all children. Subclasses can call this to recalculate the layout of all children.

CHuiStatic::LayoutTransitionTime()

Parameters

TInt aTransitionTime = 0Time for layout transition. CHuiStatic::LayoutTransitionTime() should be used as the default value, if an immediate transition is not required.

UpdateSiblingLayout(TInt)

IMPORT_C voidUpdateSiblingLayout(TIntaTransitionTime = 0)

For convenience. Updates the layout of the siblings of this visual. In other words, asks the parent layout to do a children layout.

Parameters

TInt aTransitionTime = 0Time for layout transition.

VerticalOrigin()

IMPORT_C THuiVisualVOriginVerticalOrigin()const

Determines the vertical origin.

Visual(TInt)

IMPORT_C CHuiVisual &Visual(TIntaIndex)const [virtual]

Returns a child visual.

Parameters

TInt aIndexIndex of the child visual.

VisualExtension(const TUid &, TAny **)

IMPORT_C voidVisualExtension(const TUid &aExtensionUid,
TAny **aExtensionParams
)[protected, virtual]

Parameters

const TUid & aExtensionUid
TAny ** aExtensionParams

Member Data Documentation

CHuiBrushArray * iBrushes

CHuiBrushArray *iBrushes[private]

Background brushes.

THuiTimedValue iDepthOffset

THuiTimedValue iDepthOffset

! Position / order / size of public variables must not change Depth offset.

CHuiDisplay * iDisplay

CHuiDisplay *iDisplay[private]

The display on which the visual is being shown.

THuiRealRect iDisplayRect

THuiRealRectiDisplayRect[private]

Cached display rectangle for the current frame. Defines Calculates the visual's bounding rectangle in display coordinates. The rect is always in pixels. DisplayRect()

TUint iDisplayRectFrameNumber

TUint iDisplayRectFrameNumber[private]

Describes during which frame the display rectance cache (iDisplayRect) is valid.

THuiRealRect iDisplayRectTarget

THuiRealRectiDisplayRectTarget[private]

Cached visual's bounding rectangle animation target in display coordinates. Uses the target values of the position and size, which means transitions are always immediate in the returned rectangle.

TUint iDisplayRectTargetFrameNumber

TUint iDisplayRectTargetFrameNumber[private]

Describes during which frame the display rectance target cache (iDisplayRectTarget) is valid.

TInt iFlags

TInt iFlags[private]
! Following three members are accessed by inline methods:
  • Their location (at the beginning of member data) must not change

  • Their order and size must not change Flags.

CHuiLayout * iLayout

CHuiLayout *iLayout[private]

Layout this visual belongs to (may be NULL).

TBool iLoadingEffect

TBool iLoadingEffect[private]

If effect is still being loaded (parsing), visual may need to be hided

THuiRealSize iMaxSize

THuiRealSize iMaxSize[private]

Maximum allowed size for the visual. Layouts will respect this value when layout is being updated.

TodoNeeds to be implemented.

THuiRealSize iMinSize

THuiRealSize iMinSize[private]

Minimum allowed size for the visual. Layouts will respect this value when layout is being updated.

TodoNeeds to be implemented.

THuiTimedValue iOpacity

THuiTimedValue iOpacity

Opacity of this visual. The interpolation style of opacity values by default is linear. A value of 0 is fully transparent, a value of 1 is fully opaque.

MHuiVisualOwner * iOwner

MHuiVisualOwner *iOwner[protected]

Owner of the visual.

THuiBoxMetric iPadding

THuiBoxMetric iPadding[private]

Padding between visual edges and content. The box metric can have a different amount of padding on each of the four sides.

THuiTimedPoint iPos

THuiTimedPoint iPos[private]

Position of the visual.

TRect iPreviousDrawn

TRect iPreviousDrawn[protected]

Display area that was in effect during the previous draw operation. This will be included in the dirty rectangle.

TInt iSessionId

TInt iSessionId[protected]

! ------------------------------- Session id

THuiTimedPoint iSize

THuiTimedPoint iSize[private]

Size of the visual.

HBufC8 * iTag

HBufC8 *iTag[private]

Tag.

TBool iTrackVisual

TBool iTrackVisual[protected]

Used for tracking the visual in different stages of rendering

CHuiTransformation * iTransform

CHuiTransformation *iTransform[private]

If not NULL, this transformation is used when the content visual is drawn.

THuiVisualPrivateData * iVisualData

THuiVisualPrivateData *iVisualData[private]