CAknIndicatorContainer Class Reference

class CAknIndicatorContainer : public CAknControl

The default control in the status pane's small indicator pane. This container is also used for the status indicators in navi pane and for editor indicators in queries.

Inherits from

Public Member Functions
CAknIndicatorContainer()
CAknIndicatorContainer(TInt)
~CAknIndicatorContainer()
IMPORT_C voidConstructFromResourceL(TResourceReader &)
IMPORT_C voidConstructL()
IMPORT_C TUidCreateIndicatorFromResourceL(TInt, TInt)
voidDrawPictographArea()
IMPORT_C voidHandlePointerEventL(const TPointerEvent &)
IMPORT_C voidHandleStatusPaneSizeChange()
IMPORT_C TIntIndicatorContext()
IMPORT_C TIntIndicatorState(TUid)
CAknPictographInterface *PictographInterface()
IMPORT_C voidReplaceIndicatorIconL(TUid, TInt, TInt, CFbsBitmap *, CFbsBitmap *, TInt)
IMPORT_C voidSetIncallBubbleAllowedInIdle(TBool)
IMPORT_C voidSetIncallBubbleAllowedInUsual(TBool)
IMPORT_C voidSetIncallBubbleFlags(const TInt &)
IMPORT_C voidSetIndicatorObserver(MAknIndicatorObserver *, TUid)
IMPORT_C voidSetIndicatorState(TUid, TInt, TBool)
IMPORT_C voidSetIndicatorValue(TUid, TInt, TInt)
IMPORT_C voidSetIndicatorValueL(TUid, const TDesC &)
Protected Member Functions
IMPORT_C CCoeControl *ComponentControl(TInt)
IMPORT_C TIntCountComponentControls()
IMPORT_C voidHandleResourceChange(TInt)
IMPORT_C voidPositionChanged()
IMPORT_C voidSizeChanged()
Private Member Functions
TInt CountShownIndicator()
voidCreateIncallBubbleL()
voidCreateIndicatorFromPaneResourceL(TUid, TInt, TInt)
TInt DoTick()
IMPORT_C voidDraw(const TRect &)
IMPORT_C void *ExtensionInterface(TUid)
voidIncallBubbleSizeChanged(TBool)
TBool IndicatorExists(TUid)
voidPrioritizeIndicatorsL()
voidReserved_1()
voidResetAnimTicker(TBool)
TInt SelectIndicatorLayoutMode()
voidSetContainerWindowNonFading(TBool)
voidSetIncallBubbleDisabled(TBool)
voidSetupIndicatorLayoutModes()
voidSizeChangedInExtendedStatusPane()
voidSizeChangedInFlatStatusPane()
voidSizeChangedInIdleExtendedStatusPane()
voidSizeChangedInIdleVertical()
voidSizeChangedInNormalStatusPane()
voidSizeChangedInSmallStatusPane()
voidSizeChangedInStaconPane()
TInt TickerCallback(TAny *)
TBool UpdateSmallLayoutL()
Inherited Functions
CAknControl::CAknControl()
CAknControl::~CAknControl()
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()
CCoeControl::AccumulatedZoom()const
CCoeControl::ActivateGc()const
CCoeControl::ActivateL()
CCoeControl::BackedUpWindow()const
CCoeControl::Background()const
CCoeControl::CCoeControl()
CCoeControl::CCoeControl(CCoeEnv *)
CCoeControl::CCoeControl(const CCoeControl &)
CCoeControl::CapturesPointer()const
CCoeControl::ClaimPointerGrab(TBool)
CCoeControl::ClaimPointerGrab(TInt,TBool)
CCoeControl::CloseWindow()
CCoeControl::ComponentArrayExists()const
CCoeControl::Components()
CCoeControl::Components()const
CCoeControl::ControlContext()const
CCoeControl::ControlEnv()const
CCoeControl::CopyControlContextFrom(const CCoeControl *)
CCoeControl::CreateBackedUpWindowL(RWindowTreeNode &)
CCoeControl::CreateBackedUpWindowL(RWindowTreeNode &,TDisplayMode)
CCoeControl::CreateWindowL()
CCoeControl::CreateWindowL(RWindowGroup *)
CCoeControl::CreateWindowL(RWindowTreeNode &)
CCoeControl::CreateWindowL(const CCoeControl *)
CCoeControl::CustomGc()const
CCoeControl::DeactivateGc()const
CCoeControl::DrawBackground(const TRect &)const
CCoeControl::DrawDeferred()const
CCoeControl::DrawForeground(const TRect &)const
CCoeControl::DrawNow()const
CCoeControl::DrawNow(const TRect &)const
CCoeControl::DrawableWindow()const
CCoeControl::EnableDragEvents()
CCoeControl::EnableReportControlStateChange(TBool)
CCoeControl::EnableWindowTransparency()
CCoeControl::FindBackground()const
CCoeControl::FindFontProvider()const
CCoeControl::FocusChanged(TDrawNow)
CCoeControl::GetColor(TInt,TRgb &)const
CCoeControl::GetColorUseListL(CArrayFix< TCoeColorUse > &)const
CCoeControl::GetGc()const
CCoeControl::GetHelpContext(TCoeHelpContext &)const
CCoeControl::GrabbingComponent()const
CCoeControl::GrabbingComponent(TInt)const
CCoeControl::HandleComponentControlsResourceChange(TInt)
CCoeControl::HandleControlArrayEventL(CCoeControlArray::TEvent,const CCoeControlArray *,CCoeControl *,TInt)
CCoeControl::HandlePointerBufferReadyL()
CCoeControl::HandleRedrawEvent(const TRect &)const
CCoeControl::HasBorder()const
CCoeControl::HitTest()const
CCoeControl::IgnoreEventsUntilNextPointerUp()
CCoeControl::Index(const CCoeControl *)const
CCoeControl::InitComponentArrayL()
CCoeControl::InputCapabilities()const
CCoeControl::IsActivated()const
CCoeControl::IsBackedUp()const
CCoeControl::IsBeingDestroyed()const
CCoeControl::IsBlank()const
CCoeControl::IsDimmed()const
CCoeControl::IsFocused()const
CCoeControl::IsNonFocusing()const
CCoeControl::IsReadyToDraw()const
CCoeControl::IsVisible()const
CCoeControl::LayoutManager()const
CCoeControl::MakeVisible(TBool)
CCoeControl::MaximumWidth()const
CCoeControl::MinimumSize()
CCoeControl::MopSupplyObject(TTypeUid)
CCoeControl::NotifyFontChange(const CCoeFontProvider *)
CCoeControl::Observer()const
CCoeControl::OfferKeyEventL(const TKeyEvent &,TEventCode)
CCoeControl::OverrideColorL(TInt,TRgb)
CCoeControl::OwnsWindow()const
CCoeControl::Parent()
CCoeControl::Parent()const
CCoeControl::Position()const
CCoeControl::PositionRelativeToScreen()const
CCoeControl::PrepareForFocusGainL()
CCoeControl::PrepareForFocusLossL()
CCoeControl::ProcessPointerBufferReadyL()
CCoeControl::ProcessPointerEventL(const TPointerEvent &)
CCoeControl::Rect()const
CCoeControl::RecursivelyMergeInputCapabilities(TCoeInputCapabilities &)const
CCoeControl::RecursivelyMergedInputCapabilities()const
CCoeControl::RefetchPixelMappingL()
CCoeControl::RemoveFromParent()
CCoeControl::ReportEventL(MCoeControlObserver::TCoeEvent)
CCoeControl::RequestRelayout(const CCoeControl *)
CCoeControl::ResetGc()const
CCoeControl::ScreenFont(const TCoeFont &)const
CCoeControl::SetAdjacent(TInt)
CCoeControl::SetAllowStrayPointers()
CCoeControl::SetBackground(const MCoeControlBackground *)
CCoeControl::SetBlank()
CCoeControl::SetCanDrawOutsideRect()
CCoeControl::SetComponentsToInheritVisibility(TBool)
CCoeControl::SetContainerWindowL(RBackedUpWindow &)
CCoeControl::SetContainerWindowL(RWindow &)
CCoeControl::SetContainerWindowL(const CCoeControl &)
CCoeControl::SetControlContext(MCoeControlContext *)
CCoeControl::SetCornerAndSize(TGulAlignment,const TSize &)
CCoeControl::SetCustomGc(CWindowGc *)
CCoeControl::SetDimmed(TBool)
CCoeControl::SetExtent(const TPoint &,const TSize &)
CCoeControl::SetExtentToWholeScreen()
CCoeControl::SetFocus(TBool,TDrawNow)
CCoeControl::SetFocusing(TBool)
CCoeControl::SetFontProviderL(const CCoeFontProvider &)
CCoeControl::SetGc(CWindowGc *)const
CCoeControl::SetGloballyCapturing(TBool)
CCoeControl::SetHitTest(const MCoeControlHitTest *)
CCoeControl::SetLayoutManagerL(MCoeLayoutManager *)
CCoeControl::SetMaximumWidth(TInt)
CCoeControl::SetMopParent(MObjectProvider *)
CCoeControl::SetNeighbor(CCoeControl *)
CCoeControl::SetNonFocusing()
CCoeControl::SetObserver(MCoeControlObserver *)
CCoeControl::SetParent(CCoeControl *)
CCoeControl::SetPointerCapture(TBool)
CCoeControl::SetPosition(const TPoint &)
CCoeControl::SetRect(const TRect &)
CCoeControl::SetSize(const TSize &)
CCoeControl::SetSizeWithoutNotification(const TSize &)
CCoeControl::SetTextBaselineSpacing(TInt)
CCoeControl::SetUniqueHandle(TInt)
CCoeControl::SetZoomFactorL(TInt,TZoomType)
CCoeControl::Size()const
CCoeControl::SystemGc()const
CCoeControl::TextBaselineOffset(const TSize &)const
CCoeControl::TextDrawer(TInt)const
CCoeControl::UniqueHandle()const
CCoeControl::Window()const
CCoeControl::WriteInternalStateL(RWriteStream &)const
CCoeControl::WriteInternalStateNowL(RWriteStream &)const
CCoeControl::ZoomWithType()const
CCoeControl::operator=(const CCoeControl &)
CCoeControl::~CCoeControl()
Public Member Enumerations
enumTCustomIndicatorFlags { EMultiColorIndicator = 0x1, EIndicatorPositionInverted = 0x2 }
enumTIndicatorAlignment { ELeft, ERight }
enumTIndicatorContext { EUniversalIndicators = 0, ENaviPaneEditorIndicators, EQueryEditorIndicators, EFindIndicators }
enumTIndicatorPosition { ELeftSide, ERightSide, EMiddle }
enumTLayoutMode { ELayoutModeUsual, ELayoutModeWide }
enumTLayoutOrientation { EVertical, EHorizontal }
Inherited Enumerations
CCoeControl:TZoomType
Private Member Type Definitions
typedef CArrayPtrFlat< CAknIndicator > CAknIndicatorQueue
Private Attributes
TIndicatorAlignment iAlignment
TInt iAnimatedIndicatorsShown
CAknIndicatorContainerExtension *iExtension
CIncallStatusBubble *iIncallBubble
TInt iIndicatorContext
CAknIndicatorQueue *iIndicators
TInt iIndicatorsShown
TLayoutOrientation iLayoutOrientation
TLayoutOrientation iPreviousLayoutOrientation
TBool iSpare2
TInt iSynchronizingValue
CPeriodic *iTicker
Inherited Attributes
CCoeControl::iCoeEnv
CCoeControl::iContext
CCoeControl::iPosition
CCoeControl::iSize

Constructor & Destructor Documentation

CAknIndicatorContainer()

IMPORT_CCAknIndicatorContainer()

Default constructor. Creates an EUniversalIndicators object.

CAknIndicatorContainer(TInt)

IMPORT_CCAknIndicatorContainer(TIntaIndicatorContext)

Constructor. Creates EUniversalIndicators, ENaviPaneEditorIndicators or EQueryEditorIndicators object.

Parameters

TInt aIndicatorContextIndicator container context.

~CAknIndicatorContainer()

IMPORT_C~CAknIndicatorContainer()

Destructor.

Member Functions Documentation

ComponentControl(TInt)

IMPORT_C CCoeControl *ComponentControl(TIntaIndex)const [protected, virtual]

Returns a control determined by control index.

Parameters

TInt aIndexIndex of a control to be returned.

ConstructFromResourceL(TResourceReader &)

IMPORT_C voidConstructFromResourceL(TResourceReader &aReader)[virtual]

Constructs the object from resource.

Parameters

TResourceReader & aReaderResource reader.

ConstructL()

IMPORT_C voidConstructL()

Second-phase constructor.

CountComponentControls()

IMPORT_C TIntCountComponentControls()const [protected, virtual]

Returns number of controls inside the context pane control.

CountShownIndicator()

TInt CountShownIndicator()const [private]

CreateIncallBubbleL()

voidCreateIncallBubbleL()[private]

CreateIndicatorFromPaneResourceL(TUid, TInt, TInt)

voidCreateIndicatorFromPaneResourceL(TUidaUid,
TIntaIndicatorPaneResourceId,
TIntaCustomIndicatorFlags
)[private]

Parameters

TUid aUid
TInt aIndicatorPaneResourceId
TInt aCustomIndicatorFlags

CreateIndicatorFromResourceL(TInt, TInt)

IMPORT_C TUidCreateIndicatorFromResourceL(TIntaIndicatorResourceId,
TIntaCustomIndicatorFlags
)

Creates a custom indicator. Indicators created with this method can be used in addition to default indicators.

Since
3.1

Parameters

TInt aIndicatorResourceIdResource ID of INDICATOR struct to be used in costructing indicator. UID in the resource is ignored, a dynamic UID is given to indicator and returned to caller.
TInt aCustomIndicatorFlagsFlags that can be used to set additional indicator properties.EMultiColorIndicator: Indicator is shown as multicolor (default is 2-color).EIndicatorPositionInverted: Indicator is aligned to the opposite side than default (default is right side). Note that this flag does not quarantee exact location for the indicator, indicators are shown in priority order and location may vary and look different in different layouts.

DoTick()

TInt DoTick()[private]

Draw(const TRect &)

IMPORT_C voidDraw(const TRect &aRect)const [private, virtual]

Parameters

const TRect & aRect

DrawPictographArea()

voidDrawPictographArea()

Redraws those indicators that are visible and contain pictographs.

ExtensionInterface(TUid)

IMPORT_C void *ExtensionInterface(TUidaInterface)[private, virtual]

Virtual method provided to allow extensibility of virtual behaviour

Parameters

TUid aInterface

HandlePointerEventL(const TPointerEvent &)

IMPORT_C voidHandlePointerEventL(const TPointerEvent &aPointerEvent)[virtual]

Handles pointer events.

Parameters

const TPointerEvent & aPointerEventThe pointer event.

HandleResourceChange(TInt)

IMPORT_C voidHandleResourceChange(TIntaType)[protected, virtual]

Handles a change to the control's resources of type aType which are shared across the environment, e.g. color scheme change. Responds fade events and fades incall status bubble window group.

Parameters

TInt aTypeEvent type.

HandleStatusPaneSizeChange()

IMPORT_C voidHandleStatusPaneSizeChange()

The MEikStatusPaneObserver interface allows a status pane observer to pick up changes in the size or position of the status pane. Such events will be as a result of layout changes which cause an actual change in the status pane rectangle.

IncallBubbleSizeChanged(TBool)

voidIncallBubbleSizeChanged(TBoolaAllowIdleStateBubble)[private]

Parameters

TBool aAllowIdleStateBubble

IndicatorContext()

IMPORT_C TIntIndicatorContext()const

Returns the context of the indicator container.

IndicatorExists(TUid)

TBool IndicatorExists(TUidaUid)const [private]

Parameters

TUid aUid

IndicatorState(TUid)

IMPORT_C TIntIndicatorState(TUidaIndicatorId)

Return the current state of an indicator.

Parameters

TUid aIndicatorIdID of the indicator.

PictographInterface()

CAknPictographInterface *PictographInterface()const

Returns the pictograph interface owned by the indicator container, or NULL if pictographs are not supported.

PositionChanged()

IMPORT_C voidPositionChanged()[protected, virtual]

Handles position change events.

PrioritizeIndicatorsL()

voidPrioritizeIndicatorsL()[private]

ReplaceIndicatorIconL(TUid, TInt, TInt, CFbsBitmap *, CFbsBitmap *, TInt)

IMPORT_C voidReplaceIndicatorIconL(TUidaIndicator,
TIntaState,
TIntaLayoutMode,
CFbsBitmap *aIconBitmap,
CFbsBitmap *aIconMask,
TIntaIconIndex = 0
)

Replaces the icon of the given indicator.

Since
3.1

Parameters

TUid aIndicatorUID of the indicator.
TInt aStateState which icon is replaced (EAknIndicatorStateOn or EAknIndicatorStateAnimate)
TInt aLayoutModeLayout mode of the icon to be replaced (ELayoutModeUsual or ELayoutModeWide)
CFbsBitmap * aIconBitmapBitmap of the new icon. Ownership is transferred to CAknIndicatorContainer.
CFbsBitmap * aIconMaskMask of the new icon. Ownership is transferred to CAknIndicatorContainer.
TInt aIconIndex = 0If parameter aState is EAknIndicatorStateAnimate, then this parameter must contain the index of the icon to be replaced in the animation sequence. Old icon must exist for given index so that the number of animation frames does not change.

Reserved_1()

voidReserved_1()[private, virtual]

ResetAnimTicker(TBool)

voidResetAnimTicker(TBoolbForeground)[private]

Parameters

TBool bForeground

SelectIndicatorLayoutMode()

TInt SelectIndicatorLayoutMode()[private]

SetContainerWindowNonFading(TBool)

voidSetContainerWindowNonFading(TBoolaNonFading)[private]

Parameters

TBool aNonFading

SetIncallBubbleAllowedInIdle(TBool)

IMPORT_C voidSetIncallBubbleAllowedInIdle(TBoolaAllowed)

Sets whether incall bubble is shown also on the top of the idle status pane. Normally it is shown only in usual statuspane layouts, but with this method it can be set to shown also in idle.

NOTE: This method works only if indicatorcontainer is used as container for universal indicators.

Parameters

TBool aAllowedIf true incall bubble is shown also in idle statuspane. Otherwise bubble is shown only in usual statuspane layouts.

SetIncallBubbleAllowedInUsual(TBool)

IMPORT_C voidSetIncallBubbleAllowedInUsual(TBoolaAllowed)

Sets whether incall bubble is shown on the top of the usual status pane. Normally it is shown in usual statuspane layouts, but with this method it can prevent it to be shown.

NOTE: This method works only if indicatorcontainer is used as container for universal indicators.

Parameters

TBool aAllowedIf true incall bubble is shown in usual statuspane.

SetIncallBubbleDisabled(TBool)

voidSetIncallBubbleDisabled(TBoolaDisabled)[private]

Parameters

TBool aDisabled

SetIncallBubbleFlags(const TInt &)

IMPORT_C voidSetIncallBubbleFlags(const TInt &aFlags)

Sets value to the incall status bubble indicator on the top of the status pane.

Parameters

const TInt & aFlagsMode of the bubble.

SetIndicatorObserver(MAknIndicatorObserver *, TUid)

IMPORT_C voidSetIndicatorObserver(MAknIndicatorObserver *aIndicatorObserver,
TUidaIndicatorUid
)

Sets observer for given indicator.

Parameters

MAknIndicatorObserver * aIndicatorObserverObserver of the indicator.
TUid aIndicatorUidUID of indicator to be observed.

SetIndicatorState(TUid, TInt, TBool)

IMPORT_C voidSetIndicatorState(TUidaIndicatorId,
TIntaState,
TBoolaDrawNow = ETrue
)
Sets indicator state. The state can be one of the following:
  • EAknIndicatorStateOff

  • EAknIndicatorStateOn

  • EAknIndicatorStateAnimate

Editor indicators do not support animation.

Parameters

TUid aIndicatorIdID of the indicator to be modified.
TInt aStateA state to be set to the indicator.
TBool aDrawNow = ETrueA flag to indicate if the indicator is redrawn with this call.

SetIndicatorValue(TUid, TInt, TInt)

IMPORT_C voidSetIndicatorValue(TUidaIndicatorId,
TIntaValue,
TIntaMaxValue
)

Sets value to the progress bar indicator (EAknNaviPaneEditorIndicatorProgressBar). Panics if the specified indicator is not a progress bar indicator.

Since
2.1

Parameters

TUid aIndicatorIdID of the indicator to be modified.
TInt aValueCurrent progress of the task that bar describes.
TInt aMaxValueProgress value when task is finished.

SetIndicatorValueL(TUid, const TDesC &)

IMPORT_C voidSetIndicatorValueL(TUidaIndicatorId,
const TDesC &aString
)

Sets value to the message length indicator (EAknNaviPaneEditorIndicatorMessageLength).

Parameters

TUid aIndicatorIdID of the indicator to be modified.
const TDesC & aStringValue of the indicator.

SetupIndicatorLayoutModes()

voidSetupIndicatorLayoutModes()[private]

SizeChanged()

IMPORT_C voidSizeChanged()[protected, virtual]

Handles size change events.

SizeChangedInExtendedStatusPane()

voidSizeChangedInExtendedStatusPane()[private]

SizeChangedInFlatStatusPane()

voidSizeChangedInFlatStatusPane()[private]

SizeChangedInIdleExtendedStatusPane()

voidSizeChangedInIdleExtendedStatusPane()[private]

SizeChangedInIdleVertical()

voidSizeChangedInIdleVertical()[private]

SizeChangedInNormalStatusPane()

voidSizeChangedInNormalStatusPane()[private]

SizeChangedInSmallStatusPane()

voidSizeChangedInSmallStatusPane()[private]

SizeChangedInStaconPane()

voidSizeChangedInStaconPane()[private]

TickerCallback(TAny *)

TInt TickerCallback(TAny *aThis)[private, static]

Parameters

TAny * aThis

UpdateSmallLayoutL()

TBool UpdateSmallLayoutL()[private]

Member Enumerations Documentation

Enum TCustomIndicatorFlags

Additional flags that can be used for custom indicators.

Enumerators

EMultiColorIndicator = 0x1
EIndicatorPositionInverted = 0x2

Enum TIndicatorAlignment

Alignment of the indicators.

Enumerators

ELeft
ERight

Enum TIndicatorContext

Context of the indicator container. These are used to specify what type of status indicators the indicator container contains.

Enumerators

EUniversalIndicators = 0
ENaviPaneEditorIndicators
EQueryEditorIndicators
EFindIndicators

Enum TIndicatorPosition

Position of a indicator. These are used for invidual indicators to coarsely specify where they are positioned inside the indicator container.

Enumerators

ELeftSide
ERightSide
EMiddle

Enum TLayoutMode

Layout modes of indicator container.

Enumerators

ELayoutModeUsual
ELayoutModeWide

Enum TLayoutOrientation

Layout orientations of the indicator container. These are used to specify how the indicators are laid out inside the indicator container.

Enumerators

EVertical
EHorizontal

Member Type Definitions Documentation

Typedef CAknIndicatorQueue

typedef CArrayPtrFlat< CAknIndicator >CAknIndicatorQueue[private]

Array of the indicators.

Member Data Documentation

TIndicatorAlignment iAlignment

TIndicatorAlignment iAlignment[private]

Alignment of the indicators.

TInt iAnimatedIndicatorsShown

TInt iAnimatedIndicatorsShown[private]

Number of animated indicators shown.

CAknIndicatorContainerExtension * iExtension

CAknIndicatorContainerExtension *iExtension[private]

Extension class.

CIncallStatusBubble * iIncallBubble

CIncallStatusBubble *iIncallBubble[private]

Small incall status bubble.

TInt iIndicatorContext

TInt iIndicatorContext[private]

Context of the indicators.

CAknIndicatorQueue * iIndicators

CAknIndicatorQueue *iIndicators[private]

TInt iIndicatorsShown

TInt iIndicatorsShown[private]

Number of indicators shown.

TLayoutOrientation iLayoutOrientation

TLayoutOrientation iLayoutOrientation[private]

Layout orientations.

TLayoutOrientation iPreviousLayoutOrientation

TLayoutOrientation iPreviousLayoutOrientation[private]

TBool iSpare2

TBool iSpare2[private]

Reserved for future use.

TInt iSynchronizingValue

TInt iSynchronizingValue[private]

Synchronization value used in the indicator animations.

CPeriodic * iTicker

CPeriodic *iTicker[private]

Indicator animation timer.