CAknTab Class Reference

API published in: S60 1st Ed

Link against: avkon.lib

Capability Information

Required Capabilities

None

#include <akntabgrp.h>

Inherits CAknControl.

Detailed Description

Implements tab control.

Public Types
enum   TAknTabDataType { EAknTabNone, EAknTabText, EAknTabIcon, EAknTabTextAndIcon }
  Indicates a tab title's type. More...

Public Member Functions
  ~CAknTab ()
  Destructor.
void  ReplaceTextL (const TDesC &aTabText)
  Replace a tab title.
void  SetActive (TBool aActive, TDrawNow aDrawNow)
  Activate or deactive this tab.
TBool  Active () const
  Determines whether this tab is active.
TInt  Id () const
  Gets tab's ID.
enum TAknTabDataType  TabType () const
  Gets this tab's type.
void  SetTotalAmountOfTabs (TInt aAmount)
  Sets the total amount of tabs in the tabgroup where this tab belongs.
void  SetNarrowTabLayout (TBool aNarrow)
  Sets the narrow tab layout.
virtual TSize  MinimumSize ()
  From CCoeControl.
virtual void  SetDimmed (TBool aDimmed)
  From CCoeControl.
virtual void  GetColorUseListL (CArrayFix< TCoeColorUse > &aColorUseList) const
  From CCoeControl.

Static Public Member Functions
static CAknTab *  NewL (const CCoeControl &aParent, TResourceReader &aReader)
  Two-phased constructor.
static CAknTab *  NewLC (const CCoeControl &aParent, TResourceReader &aReader)
  Two-phased constructor.
static CAknTab *  NewL (TInt aId, const CCoeControl &aParent, const TDesC &aTabText)
  Two-phased constructor.
static CAknTab *  NewLC (TInt aId, const CCoeControl &aParent, const TDesC &aTabText)
  Two-phased constructor.
static CAknTab *  NewL (TInt aId, const CCoeControl &aParent, const TDesC &aTabText, const CFbsBitmap *aTabBitmap, const CFbsBitmap *aMask=NULL)
  Two-phased constructor.
static CAknTab *  NewLC (TInt aId, const CCoeControl &aParent, const TDesC &aTabText, const CFbsBitmap *aTabBitmap, const CFbsBitmap *aMask=NULL)
  Two-phased constructor.
static CAknTab *  NewL (TInt aId, const CCoeControl &aParent, const CFbsBitmap *aTabBitmap, const CFbsBitmap *aMask=NULL)
  Two-phased constructor.
static CAknTab *  NewLC (TInt aId, const CCoeControl &aParent, const CFbsBitmap *aTabBitmap, const CFbsBitmap *aMask=NULL)
  Two-phased constructor.

Protected Member Functions
virtual void  SizeChanged ()
  From CCoeControl.
virtual TInt  CountComponentControls () const
  From CCoeControl.
virtual CCoeControl *  ComponentControl (TInt aIndex) const
  From CCoeControl.
virtual void  HandlePointerEventL (const TPointerEvent &aPointerEvent)
  From CCoeControl.

Friends
class  CAknTabGroup

Member Enumeration Documentation

enum CAknTab::TAknTabDataType
 

Indicates a tab title's type.

Enumerator:
EAknTabNone  Tab title is empty.
EAknTabText  Tab title has only text.
EAknTabIcon  Tab title has only icon.
EAknTabTextAndIcon  Tab title has both text and icon.

Constructor & Destructor Documentation

CAknTab::~CAknTab (   ) 
 

Destructor.

Member Function Documentation

TBool CAknTab::Active (   )  const
 

Determines whether this tab is active.

Returns:
ETrue if a tab is active, EFalse if not.
virtual CCoeControl* CAknTab::ComponentControl (  TInt  aIndex  )  const [protected, virtual]
 

From CCoeControl.

Gets the specified component of a compound control.

Parameters:
aIndex  The index of the control to get.
Returns:
The component control with an index of aIndex.
virtual TInt CAknTab::CountComponentControls (   )  const [protected, virtual]
 

From CCoeControl.

Gets the number of controls contained in a compound control.

Returns:
The number of component controls contained by this control.
virtual void CAknTab::GetColorUseListL (  CArrayFix< TCoeColorUse > &  aColorUseList  )  const [virtual]
 

From CCoeControl.

Gets the list of logical colors employed in the drawing of the control, paired with an explanation of how they are used. Appends the list into aColorUseList.

Parameters:
aColorUseList  The colour list.
virtual void CAknTab::HandlePointerEventL (  const TPointerEvent &  aPointerEvent  )  [protected, virtual]
 

From CCoeControl.

Handles pointer events. This function is called by framework whenever a pointer event occurs in the control.

Parameters:
aPointerEvent  The pointer event that occurs.
TInt CAknTab::Id (   )  const
 

Gets tab's ID.

Returns:
Tabs' ID.
virtual TSize CAknTab::MinimumSize (   )  [virtual]
 

From CCoeControl.

Gets a minimum size of the tab.

Returns:
A Minimum size of the tab.
static CAknTab* CAknTab::NewL (  TInt  aId,
const CCoeControl &  aParent,
const CFbsBitmap *  aTabBitmap,
const CFbsBitmap *  aMask = NULL
)  [static]
 

Two-phased constructor.

Parameters:
aId  Tab ID.
aParent  Reference to parent control.
aTabBitmap  Bitmap for the tab. Ownership of a bitmap is taken.
aMask  Bitmap's mask. Default is NULL.
Returns:
A pointer to constructed CAknTab object.
static CAknTab* CAknTab::NewL (  TInt  aId,
const CCoeControl &  aParent,
const TDesC &  aTabText,
const CFbsBitmap *  aTabBitmap,
const CFbsBitmap *  aMask = NULL
)  [static]
 

Two-phased constructor.

Parameters:
aId  Tab ID.
aParent  Reference to parent control.
aTabText  Reference to title text.
aTabBitmap  Bitmap for the tab. Ownership of a bitmap is taken.
aMask  Bitmap's mask. Default is NULL.
Returns:
A pointer to constructed CAknTab object.
static CAknTab* CAknTab::NewL (  TInt  aId,
const CCoeControl &  aParent,
const TDesC &  aTabText
)  [static]
 

Two-phased constructor.

Parameters:
aId  Tab ID.
aParent  Reference to parent control.
aTabText  Reference to title text.
Returns:
A pointer to constructed CAknTab object.
static CAknTab* CAknTab::NewL (  const CCoeControl &  aParent,
TResourceReader &  aReader
)  [static]
 

Two-phased constructor.

Parameters:
aParent  Reference to parent control.
aReader  Reference to resource reader.
Returns:
A pointer to constructed CAknTab object.
static CAknTab* CAknTab::NewLC (  TInt  aId,
const CCoeControl &  aParent,
const CFbsBitmap *  aTabBitmap,
const CFbsBitmap *  aMask = NULL
)  [static]
 

Two-phased constructor.

Parameters:
aId  Tab ID.
aParent  Reference to parent control.
aTabBitmap  Bitmap for the tab. Ownership of a bitmap is taken.
aMask  Bitmap's mask. Default is NULL.
Returns:
A pointer to constructed CAknTab object.
static CAknTab* CAknTab::NewLC (  TInt  aId,
const CCoeControl &  aParent,
const TDesC &  aTabText,
const CFbsBitmap *  aTabBitmap,
const CFbsBitmap *  aMask = NULL
)  [static]
 

Two-phased constructor.

Parameters:
aId  Tab ID.
aParent  Reference to parent control.
aTabText  Reference to title text.
aTabBitmap  Bitmap for the tab. Ownership of a bitmap is taken.
aMask  Bitmap's mask. Default is NULL.
Returns:
A pointer to constructed CAknTab object.
static CAknTab* CAknTab::NewLC (  TInt  aId,
const CCoeControl &  aParent,
const TDesC &  aTabText
)  [static]
 

Two-phased constructor.

Parameters:
aId  Tab ID.
aParent  Reference to parent control.
aTabText  Reference to title text.
Returns:
A pointer to constructed CAknTab object.
static CAknTab* CAknTab::NewLC (  const CCoeControl &  aParent,
TResourceReader &  aReader
)  [static]
 

Two-phased constructor.

Parameters:
aParent  Reference to parent control.
aReader  Reference to resource reader.
Returns:
A pointer to constructed CAknTab object.
void CAknTab::ReplaceTextL (  const TDesC &  aTabText  ) 
 

Replace a tab title.

Parameters:
aTabText  A new title text.
void CAknTab::SetActive (  TBool  aActive,
TDrawNow  aDrawNow
) 
 

Activate or deactive this tab.

Parameters:
aActive  ETrue for activation, EFalse for deactivation.
aDrawNow  Indicates whether control need to be redrawn.
virtual void CAknTab::SetDimmed (  TBool  aDimmed  )  [virtual]
 

From CCoeControl.

Sets a tab dimmed.

Parameters:
aDimmed  ETrue to dim the control, EFalse to set the control as not dimmed.
void CAknTab::SetNarrowTabLayout (  TBool  aNarrow  ) 
 

Sets the narrow tab layout.

Used by the UI framework. Applications can set the narrow layout using CAknNaviDecorator class.

void CAknTab::SetTotalAmountOfTabs (  TInt  aAmount  ) 
 

Sets the total amount of tabs in the tabgroup where this tab belongs.

virtual void CAknTab::SizeChanged (   )  [protected, virtual]
 

From CCoeControl.

Responds to size changes to sets the size and position of the contents of this control.

enum TAknTabDataType CAknTab::TabType (   )  const
 

Gets this tab's type.

Returns:
Tab's type.

Friends And Related Function Documentation

friend class CAknTabGroup [friend]
 
The documentation for this class was generated from the following file:
Copyright © Nokia Corporation 2001-2008
Back to top