CAknTitlePane Class Reference

Link against: avkon.lib

Capability Information

Required Capabilities

None

#include <akntitle.h>

Inherits CAknControl.

Detailed Description

A default control in the status pane's title pane.

Dll avkon.lib


Public Member Functions
IMPORT_C	CAknTitlePane ()
	Constructor.
IMPORT_C	~CAknTitlePane ()
	Destructor.
IMPORT_C void	ConstructL ()
	2nd phase constructor.
IMPORT_C void	ConstructFromResourceL (TResourceReader &aReader)
	Read title pane data from resource file and show it in the status pane's title pane.
IMPORT_C void	SetTextL (const TDesC &aText)
	Set a text and show it in the status pane's title pane.
IMPORT_C void	SetText (HBufC *aText)
	Sets text to the title pane.
IMPORT_C void	SetTextL (const TDesC &aText, TBool aScroll)
	Set a text and show it in the status pane's title pane.
IMPORT_C void	SetText (HBufC *aText, TBool aScroll)
	Sets text to the title pane.
const TDesC *	Text () const
	Returns text currently in the status pane's title pane.
IMPORT_C void	SetPicture (const CFbsBitmap aBitmap, const CFbsBitmap aMaskBitmap=NULL)
	Set a picture to the title pane and show it in the status pane's title pane.
IMPORT_C void	SetPictureFromFileL (const TDesC &aFileName, TInt aMainId, TInt aMaskId=-1)
	Set a picture from file and show it in the status pane's title pane.
IMPORT_C void	SetSmallPicture (const CFbsBitmap aBitmap, const CFbsBitmap aMaskBitmap, TBool aVisible)
	Set a small picture to the title pane and show it in the status pane's title pane together with text.
IMPORT_C void	SetFromResourceL (TResourceReader &aReader)
	Set data from resource file and show it in the status pane's title pane.
IMPORT_C void	SetTextToDefaultL ()
	Set default value to the status pane's title pane.
IMPORT_C TInt	MaxNumberOfVisibleTextRows () const
	Gets the maximum amount of text rows that title pane is able to display simultaneously in the currently active status pane layout.
IMPORT_C void	SetNumberOfVisibleTextRows (TInt aRows)
	Sets the number of text rows that can be used to display the text.
virtual IMPORT_C void	PrepareContext (CWindowGc &aGc) const
	Allows to modify graphics context before `Draw`.
IMPORT_C void	HandlePointerEventL (const TPointerEvent &aPointerEvent)
	Handles pointer events.
IMPORT_C void	SetTitlePaneObserver (MAknTitlePaneObserver *aObserver)
	Sets observer for title pane events.
CEikLabel *	TextLabel ()
	Gets title text label.
CEikImage *	TitleImage ()
	Gets the title image.
Protected Member Functions
virtual IMPORT_C void	SizeChanged ()
	Handles the size change events.
virtual IMPORT_C void	PositionChanged ()
	Handles the position change events.
virtual IMPORT_C void	HandleResourceChange (TInt aType)
	Handles a change to the control's resources which are shared across the environment, e.g.
virtual IMPORT_C TInt	CountComponentControls () const
	Returns number of controls inside the title pane control.
virtual IMPORT_C CCoeControl *	ComponentControl (TInt aIndex) const
	Returns a control determined by control index.
Protected Attributes
MAknTitlePaneObserver *	iTitlePaneObserver

Constructor & Destructor Documentation

IMPORT_C CAknTitlePane::CAknTitlePane

(

)

Constructor.

IMPORT_C CAknTitlePane::~CAknTitlePane

(

)

Destructor.

Member Function Documentation

virtual IMPORT_C CCoeControl* CAknTitlePane::ComponentControl ( TInt aIndex ) const [protected, virtual]

Returns a control determined by control index.

Parameters:

aIndex

Index of a control to be returned.

Returns:: Pointer to the control.

IMPORT_C void CAknTitlePane::ConstructFromResourceL

Read title pane data from resource file and show it in the status pane's title pane.

IMPORT_C void CAknTitlePane::ConstructL

(

)

2nd phase constructor.

virtual IMPORT_C TInt CAknTitlePane::CountComponentControls ( ) const [protected, virtual]

Returns number of controls inside the title pane control.

Returns:: Number of component controls.

IMPORT_C void CAknTitlePane::HandlePointerEventL

(

const TPointerEvent &

aPointerEvent

)

Handles pointer events.

Parameters:

aPointerEvent

Pointer event to be handled.

virtual IMPORT_C void CAknTitlePane::HandleResourceChange ( TInt aType ) [protected, virtual]

Handles a change to the control's resources which are shared across the environment, e.g.

skin change.

Parameters:

aType

Event type.

IMPORT_C TInt CAknTitlePane::MaxNumberOfVisibleTextRows

(

)

const

Gets the maximum amount of text rows that title pane is able to display simultaneously in the currently active status pane layout.

Typically the return value is either 2 (default portrait mode layout) or 1 (landscape mode layouts). In the extended status pane layouts the maximum number of lines is always 1.

Since release 3.2, regardless of the status pane layout, the maximum number of lines is always 1.

Since:: 3.1

Returns:: Maximum number of visible text lines.

virtual IMPORT_C void CAknTitlePane::PositionChanged ( ) [protected, virtual]

Handles the position change events.

virtual IMPORT_C void CAknTitlePane::PrepareContext ( CWindowGc & aGc ) const [virtual]

Allows to modify graphics context before Draw.

Parameters:

aGc

Graphics context to be modified.

IMPORT_C void CAknTitlePane::SetFromResourceL

Set data from resource file and show it in the status pane's title pane.

Parameters:

aReader

Resource reader of the title pane data.

IMPORT_C void CAknTitlePane::SetNumberOfVisibleTextRows

Sets the number of text rows that can be used to display the text.

The largest allowed value is the the value returned from MaxNumberOfVisibleTextRows() and the minimum value is always 1.

Since:: 3.1

Parameters:

aRows

Number of rows that can be used to display the text.

IMPORT_C void CAknTitlePane::SetPicture	(	const CFbsBitmap *	aBitmap,
		const CFbsBitmap *	aMaskBitmap = `NULL`
	)

Set a picture to the title pane and show it in the status pane's title pane.

Title pane object takes ownership of the picture. If NULL bitmap is passed, previously set image is shown.

Parameters:

	aBitmap	Bitmap to be set on the title pane.
	aMaskBitmap	Mask of the bitmap.

IMPORT_C void CAknTitlePane::SetPictureFromFileL	(	const TDesC &	aFileName,
		TInt	aMainId,
		TInt	aMaskId = `-1`
	)

Set a picture from file and show it in the status pane's title pane.

Parameters:

	aFileName	Name of the bitmap file.
	aMainId	Index of the bitmap in the bitmap file.
	aMaskId	Index of the bitmap's mask in the bitmap file.

IMPORT_C void CAknTitlePane::SetSmallPicture	(	const CFbsBitmap *	aBitmap,
		const CFbsBitmap *	aMaskBitmap,
		TBool	aVisible
	)

Set a small picture to the title pane and show it in the status pane's title pane together with text.

Title pane object takes ownership of the picture.

If NULL bitmap is passed, previously set image is used.

Since:: 3.0

Parameters:

	aBitmap	Bitmap to be set on the title pane.
	aMaskBitmap	Mask of the bitmap.
	aVisible	If `ETrue`, picture is set visible. Otherwise only text is shown.

IMPORT_C void CAknTitlePane::SetText	(	HBufC *	aText,
		TBool	aScroll
	)

Sets text to the title pane.

If whole text does not fit into titlepane, it will be scrolled once and then shown in truncated form.

Since:: 3.0

Parameters:

	aText	New text. This object takes ownership of `aText`. If `NULL` is given then already existing text's scrollability will be changed according to `aScroll`.
	aScroll	If ETrue text is scrolled when needed, otherwise not.