CFsAlfScrollbarLayout Class Reference

class CFsAlfScrollbarLayout : public CAlfLayout

Scrollbar layout. This class creates a layout visual with scrollbars in it. Both horizontal and vertical scrollbars are supported. Scrollbars have three modes: show, hide and auto. When set to show the scrollbar is always visible. Hide setting keeps the scrollbar always hidden. Auto setting determines if the scrollbar is needed or not. Each scrollbar can have different visibility setting.

   ?good_class_usage_example(s)
?library
Since
S60 ?S60_version *** for example, S60 v3.0

Inherits from

Public Member Functions
~CFsAlfScrollbarLayout()
IMPORT_C CFsAlfScrollbarLayout *AddNewL(CAlfControl &, CAlfLayout *)
IMPORT_C TBoolIsScrollbarVisible(TFsScrollbar)
IMPORT_C TAlfRealPointLayoutSize()
IMPORT_C TIntRangeEnd(TFsScrollbar)
IMPORT_C TIntRangeStart(TFsScrollbar)
IMPORT_C TIntScrollbarPos(TFsScrollbar)
IMPORT_C voidSetHorizontalScrollbarHeight(TInt, TInt)
IMPORT_C voidSetRange(TInt, TInt, TFsScrollbar)
IMPORT_C voidSetScrollbarImagesL(CAlfImageBrush *, CAlfImageBrush *, TFsScrollbar)
IMPORT_C voidSetScrollbarPos(const TInt, TFsScrollbar)
IMPORT_C voidSetThumbSpan(TInt, TFsScrollbar)
IMPORT_C voidSetVerticalScrollbarWidth(TInt, TInt)
IMPORT_C voidSetVisibilityMode(TFsScrollbarVisibility, TFsScrollbar)
IMPORT_C TIntThumbSpan(TFsScrollbar)
IMPORT_C voidUpdate(TInt)
IMPORT_C TFsScrollbarVisibilityVisibilityMode(TFsScrollbar)
Private Member Functions
CFsAlfScrollbarLayout()
voidConstructL(CAlfControl &)
voidReleaseCustomImage(TFsScrollbar)
voidSendCommand(TFsScrollbarCommand, TFsScrollbarSet &)
voidSendCommand(TFsScrollbarCommand, TFsScrollbarSet &, TFsScrollbarSet &)
Inherited Functions
CAlfLayout::Append(CAlfVisual *,TBool,TInt)
CAlfLayout::BaseUnit()const
CAlfLayout::CAlfLayout()
CAlfLayout::ChildOrdinal(TInt)
CAlfLayout::ChildPos(TInt,TPoint &)
CAlfLayout::ChildSize(TInt,TSize &)
CAlfLayout::Count()const
CAlfLayout::DoRemoveAndDestroyAllD()
CAlfLayout::EffectiveLayoutOrdinal(const CAlfVisual &)const
CAlfLayout::EnableScrollingL(TBool)
CAlfLayout::FindTag(const TDesC8 &)
CAlfLayout::FindVisual(CAlfVisual *)const
CAlfLayout::HorizontalInnerPadding()const
CAlfLayout::InnerPadding()const
CAlfLayout::InnerPaddingAsMetric()const
CAlfLayout::InnerPaddingInBaseUnits()const
CAlfLayout::Insert(CAlfVisual *,TInt)
CAlfLayout::MoveVisualToBack(CAlfVisual &,TInt)
CAlfLayout::MoveVisualToFront(CAlfVisual &,TInt)
CAlfLayout::PropertyOwnerExtension(const TUid &,TAny **)
CAlfLayout::Remove(CAlfVisual *,TInt)
CAlfLayout::RemoveAndDestroyAllD()
CAlfLayout::Reorder(CAlfVisual &,TInt,TInt)
CAlfLayout::ScrollOffset()const
CAlfLayout::Scrolling()const
CAlfLayout::SetBaseUnit(const TAlfMetric &)
CAlfLayout::SetBaseUnit(const TAlfXYMetric &)
CAlfLayout::SetInnerPadding(const TAlfXYMetric &)
CAlfLayout::SetInnerPadding(const TPoint &)
CAlfLayout::SetScrollOffset(const TAlfTimedPoint &)
CAlfLayout::SetTransitionTime(TInt)
CAlfLayout::TransitionTime()const
CAlfLayout::UpdateChildrenLayout(TInt)
CAlfLayout::VerticalInnerPadding()const
CAlfLayout::VirtualSize()const
CAlfLayout::Visual(TInt)const
CAlfLayout::~CAlfLayout()
CAlfPropertyOwner::CAlfPropertyOwner()
CAlfPropertyOwner::CopyProperty(const CAlfPropertyOwner &,const TDesC8 &)
CAlfPropertyOwner::PropertyClear()
CAlfPropertyOwner::PropertyFindInteger(const TDesC8 &,TInt *)const
CAlfPropertyOwner::PropertyFindString(const TDesC8 &,TDesC **)const
CAlfPropertyOwner::PropertyRemove(const TDesC8 &)
CAlfPropertyOwner::PropertySetIntegerL(const TDesC8 &,TInt,TInt,TInt)
CAlfPropertyOwner::PropertySetStringL(const TDesC8 &,const TDesC &)
CAlfPropertyOwner::~CAlfPropertyOwner()
CAlfVisual::AlignByOrigin(TAlfRealRect &)const
CAlfVisual::Brushes()
CAlfVisual::CAlfVisual()
CAlfVisual::ClearFlag(TAlfVisualFlags)
CAlfVisual::ClearFlags(TUint)
CAlfVisual::Clipping()const
CAlfVisual::Comms()const
CAlfVisual::ConstructL(CAlfControl &,TInt,TInt,const TDesC8 &)
CAlfVisual::CopyValues(const CAlfVisual &,TInt,TInt)
CAlfVisual::DepthOffset()const
CAlfVisual::Display()const
CAlfVisual::DisplayRect()const
CAlfVisual::DisplayRectTarget()const
CAlfVisual::DisplayToLocal(const TAlfRealPoint &)const
CAlfVisual::DisplayToLocal(const TPoint &)const
CAlfVisual::DropShadowHandler()const
CAlfVisual::EffectiveOpacity()const
CAlfVisual::EnableBrushesL(TBool)
CAlfVisual::EnableDropShadowL(TBool)
CAlfVisual::EnableTransformationL(TBool)
CAlfVisual::Env()const
CAlfVisual::Flags()const
CAlfVisual::HasTactileFeedback(TInt)const
CAlfVisual::HorizontalOrigin()const
CAlfVisual::HorizontalPadding()const
CAlfVisual::Identifier()const
CAlfVisual::IsTagged()const
CAlfVisual::Layout()const
CAlfVisual::LocalToDisplay(const TAlfRealPoint &)const
CAlfVisual::LocalToDisplay(const TPoint &)const
CAlfVisual::MaxSize()const
CAlfVisual::MaxSizeInBaseUnits()const
CAlfVisual::Mimic(CAlfVisual &,TInt)
CAlfVisual::MinSize()const
CAlfVisual::MinSizeInBaseUnits()const
CAlfVisual::Move(const TAlfRealPoint &,TInt)
CAlfVisual::Move(const TPoint &,TInt)
CAlfVisual::MoveToFront(TInt)
CAlfVisual::Opacity()const
CAlfVisual::Owner()const
CAlfVisual::Padding()const
CAlfVisual::PaddingAsMetric()const
CAlfVisual::PaddingInPixels()const
CAlfVisual::Pause(TInt)
CAlfVisual::Pos()const
CAlfVisual::RemoveTactileFeedback(TInt)
CAlfVisual::Resume(TInt)
CAlfVisual::SetCenteredPosAndSize(const TAlfRealPoint &,const TAlfRealSize &,TInt)
CAlfVisual::SetCenteredPosAndSize(const TPoint &,const TSize &,TInt)
CAlfVisual::SetClipping(TBool)
CAlfVisual::SetDepthOffset(const TAlfTimedValue &)
CAlfVisual::SetDisplay(CAlfDisplay *)
CAlfVisual::SetEffectL(const TDesC &)
CAlfVisual::SetFlag(TAlfVisualFlags)
CAlfVisual::SetFlags(TUint)
CAlfVisual::SetGroupEffectL(const TDesC &,TInt)
CAlfVisual::SetLayout(CAlfLayout *)
CAlfVisual::SetMaxSize(const TAlfRealSize &)
CAlfVisual::SetMaxSize(const TSize &)
CAlfVisual::SetMinSize(const TAlfRealSize &)
CAlfVisual::SetMinSize(const TSize &)
CAlfVisual::SetOpacity(const TAlfTimedValue &)
CAlfVisual::SetOrigin(TAlfVisualHOrigin,TAlfVisualVOrigin)
CAlfVisual::SetOwner(CAlfControl &)
CAlfVisual::SetPadding(TInt)
CAlfVisual::SetPadding(const TAlfBoxMetric &)
CAlfVisual::SetPadding(const TPoint &)
CAlfVisual::SetPos(const TAlfRealPoint &,TInt)
CAlfVisual::SetPos(const TAlfTimedPoint &)
CAlfVisual::SetRect(const TAlfRealRect &,TInt)
CAlfVisual::SetSize(const TAlfRealSize &,TInt)
CAlfVisual::SetSize(const TAlfTimedPoint &)
CAlfVisual::SetTactileFeedbackL(TInt,TInt)
CAlfVisual::SetTagL(const TDesC8 &)
CAlfVisual::Size()const
CAlfVisual::Tag()const
CAlfVisual::TagMatches(const TDesC8 &)const
CAlfVisual::Transformation()
CAlfVisual::VerticalOrigin()const
CAlfVisual::VerticalPadding()const
CAlfVisual::~CAlfVisual()
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()
Inherited Enumerations
CAlfLayout:TExpansionFlags
Private Attributes
CAlfImageBrush *iHBarBrush
CAlfVisual *iHScrollbar
CAlfDeckLayout *iHScrollbarLayout
CAlfDeckLayout *iHThumb
CAlfImageBrush *iHThumbBrush
CAlfControl *iOwnerControl
CAlfImageBrush *iVBarBrush
CAlfVisual *iVScrollbar
CAlfDeckLayout *iVScrollbarLayout
CAlfDeckLayout *iVThumb
CAlfImageBrush *iVThumbBrush

Constructor & Destructor Documentation

CFsAlfScrollbarLayout()

CFsAlfScrollbarLayout()[private]

~CFsAlfScrollbarLayout()

~CFsAlfScrollbarLayout()[virtual]

Destructor.

Member Functions Documentation

AddNewL(CAlfControl &, CAlfLayout *)

IMPORT_C CFsAlfScrollbarLayout *AddNewL(CAlfControl &aOwnerControl,
CAlfLayout *aParentLayout = NULL
)[static]

Construct a new scrollbar layout and give its ownership to a control.

Parameters

CAlfControl & aOwnerControlOwner control.
CAlfLayout * aParentLayout = NULLParent layout for the new layout.

ConstructL(CAlfControl &)

voidConstructL(CAlfControl &aOwner)[private, virtual]

From CAlfVisual. Second-phase constructor.

Parameters

CAlfControl & aOwner

IsScrollbarVisible(TFsScrollbar)

IMPORT_C TBoolIsScrollbarVisible(TFsScrollbaraScrollbar = EFsScrollbarVertical)

Resolve if the specified scrollbar is visible.

Parameters

TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

LayoutSize()

IMPORT_C TAlfRealPointLayoutSize()

Get the target size of the scrolbar layout without the scrollbars.

RangeEnd(TFsScrollbar)

IMPORT_C TIntRangeEnd(TFsScrollbaraScrollbar = EFsScrollbarVertical)

Get scrollbar's maximum range value.

Parameters

TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

RangeStart(TFsScrollbar)

IMPORT_C TIntRangeStart(TFsScrollbaraScrollbar = EFsScrollbarVertical)

Get scrollbar's minimum range value.

Parameters

TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

ReleaseCustomImage(TFsScrollbar)

voidReleaseCustomImage(TFsScrollbaraScrollbar)[private]

Release custom image reserved memory.

Parameters

TFsScrollbar aScrollbarThe scrollbar at issue.

ScrollbarPos(TFsScrollbar)

IMPORT_C TIntScrollbarPos(TFsScrollbaraScrollbar = EFsScrollbarVertical)

Resolve the current scrollbar position.

Parameters

TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

SendCommand(TFsScrollbarCommand, TFsScrollbarSet &)

voidSendCommand(TFsScrollbarCommandaCommandId,
TFsScrollbarSet &aInScrollbarSet
)[private]

Send a command to server.

Parameters

TFsScrollbarCommand aCommandIdId of the command to be sent.
TFsScrollbarSet & aInScrollbarSetData for the used command.

SendCommand(TFsScrollbarCommand, TFsScrollbarSet &, TFsScrollbarSet &)

voidSendCommand(TFsScrollbarCommandaCommandId,
TFsScrollbarSet &aInScrollbarSet,
TFsScrollbarSet &aOutScrollbarSet
)[private]

Send a command to server.

Parameters

TFsScrollbarCommand aCommandIdId of the command to be sent.
TFsScrollbarSet & aInScrollbarSetPlaceholder for received data.
TFsScrollbarSet & aOutScrollbarSet

SetHorizontalScrollbarHeight(TInt, TInt)

IMPORT_C voidSetHorizontalScrollbarHeight(TIntaHeight,
TIntaTransitionTime = 0
)

Adjust the horizontal scrollbar's height.

Parameters

TInt aHeightNew height.
TInt aTransitionTime = 0How long the transition should take visually, in milliseconds.

SetRange(TInt, TInt, TFsScrollbar)

IMPORT_C voidSetRange(TIntaStart,
TIntaEnd,
TFsScrollbaraScrollbar = EFsScrollbarVertical
)

Set the range of the scrollbar. Will not actually move the scrollbar until Update() is called.

Parameters

TInt aStartSmallest value the scrollbar position can be set to.
TInt aEndLargest value the scrollbar position can be set to.
TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

SetScrollbarImagesL(CAlfImageBrush *, CAlfImageBrush *, TFsScrollbar)

IMPORT_C voidSetScrollbarImagesL(CAlfImageBrush *aBarBrush,
CAlfImageBrush *aThumbBrush,
TFsScrollbaraScrollbar
)

Change the bar image to custom image. Ownership of the brushes are changed.

Parameters

CAlfImageBrush * aBarBrushBrush with the new bar image.
CAlfImageBrush * aThumbBrushBrush with the new thumb image.
TFsScrollbar aScrollbarThe scrollbar at issue.

SetScrollbarPos(const TInt, TFsScrollbar)

IMPORT_C voidSetScrollbarPos(const TIntaPos,
TFsScrollbaraScrollbar = EFsScrollbarVertical
)

Set the position of the scrollbar. Will not actually move the scrollbar until Update() is called.

Parameters

const TInt aPosIndex of the first item visible, i.e. the index of the topmost item in a list box.
TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

SetThumbSpan(TInt, TFsScrollbar)

IMPORT_C voidSetThumbSpan(TIntaThumbSpan,
TFsScrollbaraScrollbar = EFsScrollbarVertical
)

Set the count of the visible unit.

Parameters

TInt aThumbSpanCount of the units that is visible at a time.
TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

SetVerticalScrollbarWidth(TInt, TInt)

IMPORT_C voidSetVerticalScrollbarWidth(TIntaWidth,
TIntaTransitionTime = 0
)

Adjust the vertical scrollbar's width.

Parameters

TInt aWidthNew width.
TInt aTransitionTime = 0How long the transition should take visually, in milliseconds.

SetVisibilityMode(TFsScrollbarVisibility, TFsScrollbar)

IMPORT_C voidSetVisibilityMode(TFsScrollbarVisibilityaVisibility,
TFsScrollbaraScrollbar = EFsScrollbarVertical
)

Set the scrollbar visibility.

Parameters

TFsScrollbarVisibility aVisibilityNew visibility mode for the scrollbar.
TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

ThumbSpan(TFsScrollbar)

IMPORT_C TIntThumbSpan(TFsScrollbaraScrollbar = EFsScrollbarVertical)

Resolve the count of the units that is visible at a time.

Parameters

TFsScrollbar aScrollbar = EFsScrollbarVerticalThe scrollbar at issue.

Update(TInt)

IMPORT_C voidUpdate(TIntaLayoutTransitionTime = 0)

Update the visibility of scrollbars.

Parameters

TInt aLayoutTransitionTime = 0How long the transition should take visually, in milliseconds.

VisibilityMode(TFsScrollbar)

IMPORT_C TFsScrollbarVisibilityVisibilityMode(TFsScrollbaraScrollbar = EFsScrollbarVertical)

Resolve the scrollbar visibility.

Parameters

TFsScrollbar aScrollbar = EFsScrollbarVertical

Member Data Documentation

CAlfImageBrush * iHBarBrush

CAlfImageBrush *iHBarBrush[private]

CAlfVisual * iHScrollbar

CAlfVisual *iHScrollbar[private]

Background image for the horizontal scrollbar. Not own.

CAlfDeckLayout * iHScrollbarLayout

CAlfDeckLayout *iHScrollbarLayout[private]

The layout that contains the entire horizontal scrollbar. Not own.

CAlfDeckLayout * iHThumb

CAlfDeckLayout *iHThumb[private]

Visual for the horizontal scrollbar thumb (part that scrolls around). Not own.

CAlfImageBrush * iHThumbBrush

CAlfImageBrush *iHThumbBrush[private]

CAlfControl * iOwnerControl

CAlfControl *iOwnerControl[private]

?description_of_pointer_member Not own.

CAlfImageBrush * iVBarBrush

CAlfImageBrush *iVBarBrush[private]

CAlfVisual * iVScrollbar

CAlfVisual *iVScrollbar[private]

Background image for the vertical scrollbar. Not own.

CAlfDeckLayout * iVScrollbarLayout

CAlfDeckLayout *iVScrollbarLayout[private]

The layout that contains the entire vertical scrollbar. Not own.

CAlfDeckLayout * iVThumb

CAlfDeckLayout *iVThumb[private]

Visual for the vertical scrollbar thumb (part that scrolls around). Not own.

CAlfImageBrush * iVThumbBrush

CAlfImageBrush *iVThumbBrush[private]