TEikScrollBarModel Class Reference

#include <mw/eikscrlb.h>

class TEikScrollBarModel

Detailed Description

Scroll bar models encapsulate the range of integers which a scroll bar can represent, from zero to n, and the current position of the scroll bar thumb within that range.

Supported from Symbian 5.0.

Member Attribute Documentation

iScrollSpan

TInt iScrollSpan

Entire range of integers for this model.

iThumbPosition

TInt iThumbPosition

Position of the low edge of the thumb within 0...iScrollSpan.

iThumbSpan

TInt iThumbSpan

Range spanned by the thumb.

Member Enumeration Documentation

Enum TEikScrollBarModelType

Type of scroll bar model. The different models store the scrolling information in different way, so correct model must be used with correct scrollbar type.

EnumeratorValueDescription
EEikScrollBarModel0x00000000

This model type is for storing data for the arrowhead scrollbar.

EAknDoubleSpanScrollBarModel0x80000000

This model type is for storing data for the spanned scrollbar.

Constructor & Destructor Documentation

TEikScrollBarModel ( )

TEikScrollBarModel()[inline]

C++ default constructor. Creates, allocates and initialises a new TEikScrollBarModel.

TEikScrollBarModel ( TInt, TInt, TInt )

IMPORT_CTEikScrollBarModel(TIntaScrollSpan,
TIntaThumbSpan = 0,
TIntaThumbPosition = 0
)

Constructor. Creates, allocates and initialises a new TEikScrollBarModel.

ParameterDescription
aScrollSpanThe span of this model, numbered from zero.
aThumbSpanNumber of positions spanned by the thumb.In default this is zero.
aThumbPositionPosition of the thumb within the model span. In default this is zero.

Member Function Documentation

CheckBounds ( )

IMPORT_C voidCheckBounds()

Ensures that the thumb position remains within its valid range by altering it if necessary.

MaxThumbPos ( )

IMPORT_C TIntMaxThumbPos()const

Gets the maximum position possible for the low edge of the thumb within the total span.

Returns: Maximum value possible for iThumbPosition.

ScrollBarModelType ( )

TEikScrollBarModel::TEikScrollBarModelType ScrollBarModelType()const

Gets type of scroll bar model which is one of the enum values from TEikScrollBarModelType enum.

ScrollBarUseful ( )

IMPORT_C TBoolScrollBarUseful()const

Tests whether the scroll bar model is useful. Scroll bar models are only useful if their thumb span is smaller than their entire span.

Returns: Whether this scroll bar can be used.

operator!= ( const TEikScrollBarModel )

TBool operator!=(const TEikScrollBarModelaModel)const [inline]

Tests two models for inequality. The two models are the current model and the model specified by aModel.

Returns: ETrue if the two models are not equal.

operator== ( const TEikScrollBarModel )

IMPORT_C TBooloperator==(const TEikScrollBarModelaModel)const

Tests two models for equality. The two models are the current model and the model specified by aModel.

Returns: ETrue if the two models are equal.