MMsgBioControl Class Reference

#include <app/mmsgbiocontrol.h>

class MMsgBioControl
Public Member Functions
pure virtual TRect CurrentLineRect()
pure virtual TBool HandleBioCommandL(TInt)
pure virtual HBufC *HeaderTextL(void)
pure virtual TBool IsCursorLocation(TMsgCursorLocation)
pure virtual TBool IsFocusChangePossible(TMsgFocusDirection)
pure virtual TUint32 OptionMenuPermissionsL()
pure virtual voidSetAndGetSizeL(TSize &)
pure virtual voidSetMenuCommandSetL(CEikMenuPane &)
pure virtual TInt VirtualHeight()
pure virtual TInt VirtualVisibleTop()

Detailed Description

The interface for Bio controls

Member Function Documentation

CurrentLineRect ( )

TRect CurrentLineRect()const [pure virtual]

Returns a rectangle slice of the bio controls viewing area. It is used by the CMsgEditorView class for scrolling the screen. The position is given relative to the bio controls top left corner.

Returns: TRect

HandleBioCommandL ( TInt )

TBool HandleBioCommandL(TIntaCommand)[pure virtual]

The command handler. The Bio Control should only handle its own commands that it has set using the function SetMenuCommandSetL().

ParameterDescription
aCommandID of command to be handled.

Returns: If the command is handled, it returns ETrue, and vice versa

HeaderTextL ( void )

HBufC *HeaderTextL(void)const [pure virtual]

Returns the header text.

Returns: The header text.

IsCursorLocation ( TMsgCursorLocation )

TBool IsCursorLocation(TMsgCursorLocationaLocation)const [pure virtual]

Tells whether the cursor is in the topmost or bottom position. It is used by the scrolling framework.

ParameterDescription
aLocationSpecifies either top or bottom.

Returns: ETrue if the cursor is in the part specified by aLocation.

IsFocusChangePossible ( TMsgFocusDirection )

TBool IsFocusChangePossible(TMsgFocusDirectionaDirection)const [pure virtual]

Used by the body container for managing focus and scrolling.

ParameterDescription
aDirectionThe direction to be checked.

Returns: ETrue if focus change is possible, and vice versa.

OptionMenuPermissionsL ( )

TUint32 OptionMenuPermissionsL()const [pure virtual]

The application can get the option menu permissions using this function.

Returns: The option menu permission flags. If the flag is off it means that the option menu command is not recommended with this Bio Control.

SetAndGetSizeL ( TSize & )

voidSetAndGetSizeL(TSize &aSize)[pure virtual]

Calculates and sets size for a Bio control according to aSize. This function might become deprecated. The SetSizeL() function will be the replacement. The height of the Bio control may be less or more than requested by aSize, but the width must be exactly the same. If width of the Bio control is not the same as given by aSize, the width must be reset back to requested one. The aSize is set to the new size.

ParameterDescription
aSizeSize. See explanation.

SetMenuCommandSetL ( CEikMenuPane & )

voidSetMenuCommandSetL(CEikMenuPane &aMenuPane)[pure virtual]

This is called by the container to allow the Bio control to add a menu item command. The command ID's should start from the value returned by the MMsgBioControlObserver::FirstFreeCommand().

ParameterDescription
aMenuPaneReference to the applications menu which will be modified.

VirtualHeight ( )

TInt VirtualHeight()[pure virtual]

Gives the height of the text in pixels. It is used by the scrolling framework.

Returns: Height of the text in pixels.

VirtualVisibleTop ( )

TInt VirtualVisibleTop()[pure virtual]

Gives the cursor position in pixels. It is used by the scrolling framework.

Returns: Cursor position in pixels.