CEikProgressInfo Class Reference

class CEikProgressInfo : public CEikBorderedControl

Control used to indicate the progress of an operation.

Progress consists of a rectangular block that grows during an increment and shrinks during a decrement. The control can have progress text within the bar that provides updated information on how far the operation has progressed. The text can be displayed as either a percentage or a fraction. The bar can also have a series of invisible splits, or lines. These splits are displayed by the rectangular blocks as it fills the bar. When the control is in this mode progress text cannot be used.

This class has an associated PROGRESSINFO resource and EEikCtProgInfo control factory identifier.

Public Member Functions
CEikProgressInfo()
CEikProgressInfo(const SInfo &)
~CEikProgressInfo()
IMPORT_C voidActivateL()
IMPORT_C voidConstructFromResourceL(TResourceReader &)
IMPORT_C voidConstructL()
TInt CurrentValue()
IMPORT_C voidGetColorUseListL(CArrayFix< TCoeColorUse > &)
IMPORT_C voidHandlePointerEventL(const TPointerEvent &)
IMPORT_C voidHandleResourceChange(TInt)
IMPORT_C voidIncrementAndDraw(TInt)
const SInfo &Info()
const SLayout &Layout()
IMPORT_C TSizeMinimumSize()
IMPORT_C voidSetAndDraw(TInt)
IMPORT_C voidSetBorder(const TGulBorder &)
IMPORT_C voidSetFinalValue(TInt)
IMPORT_C voidSetLayout(const SLayout &)
IMPORT_C voidSizeChanged()
Protected Member Functions
IMPORT_C const TDesC *EvaluateText(TDes &)
IMPORT_C voidWriteInternalStateL(RWriteStream &)
Private Member Functions
voidCheckSizeCalculated()
voidConstruct()
voidDeleteBitmaps()
IMPORT_C voidDraw(const TRect &)
voidDrawPartial()
voidDrawProgressBarBackground(CWindowGc &)
voidDrawProgressBarForeground(CWindowGc &)
IMPORT_C void *ExtensionInterface(TUid)
TInt FilledWidth()
voidLoadBitmapsL()
IMPORT_C voidReserved_2()
voidSetBitmapSizes()
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::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::ComponentControl(TInt)const
CCoeControl::Components()
CCoeControl::Components()const
CCoeControl::ControlContext()const
CCoeControl::ControlEnv()const
CCoeControl::CopyControlContextFrom(const CCoeControl *)
CCoeControl::CountComponentControls()const
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::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::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::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::PositionChanged()
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::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::WriteInternalStateNowL(RWriteStream &)const
CCoeControl::ZoomWithType()const
CCoeControl::operator=(const CCoeControl &)
CCoeControl::~CCoeControl()
CEikBorderedControl::Border()const
CEikBorderedControl::CEikBorderedControl()
CEikBorderedControl::CEikBorderedControl(const TGulBorder &)
CEikBorderedControl::HasBorder()const
CEikBorderedControl::SetAdjacent(TInt)
CEikBorderedControl::SetBorder(TGulBorder::TBorderType)
CEikBorderedControl::SetBorder(TInt)
Inherited Enumerations
CCoeControl:TZoomType
Private Attributes
CFbsBitmap *iBackgroundBitmap
CFbsBitmap *iBitmap
CFbsBitmap *iBitmapMask
TInt iCurrentValue
CEikProgressInfoExtension *iExtension
TBool iHeightWasSupplied
SInfo iInfo
SLayout iLayout
Inherited Attributes
CCoeControl::iCoeEnv
CCoeControl::iContext
CCoeControl::iPosition
CCoeControl::iSize
CEikBorderedControl::iBorder

Constructor & Destructor Documentation

CEikProgressInfo()

IMPORT_CCEikProgressInfo()

C++ default constructor.

CEikProgressInfo(const SInfo &)

IMPORT_CCEikProgressInfo(const SInfo &aProgInfo)

Constructs a progress information control using the information held in the specified SInfo struct. Uses default layout values.

Parameters

const SInfo & aProgInfoHolds information about the type of progress information control.

~CEikProgressInfo()

IMPORT_C~CEikProgressInfo()

Destructor.

Member Functions Documentation

ActivateL()

IMPORT_C voidActivateL()[virtual]

From CCoeControl.

Activates the progress information control.

CheckSizeCalculated()

voidCheckSizeCalculated()[private]

Construct()

voidConstruct()[private]

ConstructFromResourceL(TResourceReader &)

IMPORT_C voidConstructFromResourceL(TResourceReader &aReader)[virtual]

From CCoeControl.

Constructs a progress information control from a PROGRESSINFO resource. Uses default layout values.

Parameters

TResourceReader & aReaderThe resource reader to use.

ConstructL()

IMPORT_C voidConstructL()

By default Symbian 2nd phase constructor is private.

CurrentValue()

TInt CurrentValue()const [inline]

Gets the current value, indicating how far the operation has progressed.

DeleteBitmaps()

voidDeleteBitmaps()[private]

Draw(const TRect &)

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

From CCoeControl. Draws the border around the control. This function also clears the central area if the IsBlank() method returns ETrue.

From CCoeControl

CCoeControl::IsBlank() Border()

Parameters

const TRect & aRectNot used.

DrawPartial()

voidDrawPartial()const [private]

DrawProgressBarBackground(CWindowGc &)

voidDrawProgressBarBackground(CWindowGc &aGc)const [private]

Parameters

CWindowGc & aGc

DrawProgressBarForeground(CWindowGc &)

voidDrawProgressBarForeground(CWindowGc &aGc)const [private]

Parameters

CWindowGc & aGc

EvaluateText(TDes &)

IMPORT_C const TDesC *EvaluateText(TDes &aTextBuf)const [protected, virtual]

Evaluates the progress text.

Parameters

TDes & aTextBufOn return, the evaluted text. This is the same as the return value.

ExtensionInterface(TUid)

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

Parameters

TUid aInterface

FilledWidth()

TInt FilledWidth()const [private]

GetColorUseListL(CArrayFix< TCoeColorUse > &)

IMPORT_C voidGetColorUseListL(CArrayFix< TCoeColorUse > &aColorUseList)const [virtual]

From CCoeControl.

Gets a list of the logical colours used to draw the control, appended to aColorUseList.

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 to aColorUseList.

Since
ER5U

Parameters

CArrayFix< TCoeColorUse > & aColorUseListOn return, the colours used to draw the control.

HandlePointerEventL(const TPointerEvent &)

IMPORT_C voidHandlePointerEventL(const TPointerEvent &aPointerEvent)[virtual]

From CCoeControl.

Handles pointer events. This function gets called whenever a pointer event occurs in the control, i.e. when the pointer is within the control's extent, or when the control has grabbed the pointer. The control should implement this function to handle pointer events.

Note: events of type EButton1Down are processed before HandlePointerEventL() is called, in order to transfer keyboard focus to the control in which the EButton1Down event occurred. If overriding HandlePointerEventL(), the implementation must include a base call to CCoeControl's HandlePointerEventL().

Parameters

const TPointerEvent & aPointerEventThe pointer event.

HandleResourceChange(TInt)

IMPORT_C voidHandleResourceChange(TIntaType)[virtual]

From CCoeControl.

Handles a change to the control's resources.

Handles a change to the control's resources of type aType which are shared across the environment, e.g. colors or fonts.

Since
ER5U

Parameters

TInt aTypeA message UID value.

IncrementAndDraw(TInt)

IMPORT_C voidIncrementAndDraw(TIntaInc)

Adds the specified increment to the current progress value and, if the progress value has increased, redraws the control.

Parameters

TInt aIncThe increment to add to the current progress value.

Info()

const SInfo &Info()const [inline]

Gets a pointer to the information used to define the progress information control's type.

Layout()

const SLayout &Layout()const [inline]

Gets a pointer to the colours and layout of the progress information control.

LoadBitmapsL()

voidLoadBitmapsL()[private]

MinimumSize()

IMPORT_C TSizeMinimumSize()[virtual]

From CCoeControl.

Gets the minimum size required to draw the control.

Reserved_2()

IMPORT_C voidReserved_2()[private, virtual]

SetAndDraw(TInt)

IMPORT_C voidSetAndDraw(TIntaValue)

Sets the specified value as the new progress value and redraws the control if the new value differs from the old value.

Parameters

TInt aValueThe new progress value.

SetBitmapSizes()

voidSetBitmapSizes()[private]

SetBorder(const TGulBorder &)

IMPORT_C voidSetBorder(const TGulBorder &aBorder)

Sets the control's border.

Parameters

const TGulBorder & aBorderThe control's border.

SetFinalValue(TInt)

IMPORT_C voidSetFinalValue(TIntaFinalValue)

Sets the final value for the progress information control. This value indicates the operation being monitored is complete.

Parameters

TInt aFinalValueThe final value for the progress information control. If this is specified as zero, the value is set to one.

SetLayout(const SLayout &)

IMPORT_C voidSetLayout(const SLayout &aLayout)

Sets the layout for the control.

Parameters

const SLayout & aLayoutThe layout for the control.

SizeChanged()

IMPORT_C voidSizeChanged()[virtual]

From CCoeControl.

Recalculates the control's size in response to a size change.

WriteInternalStateL(RWriteStream &)

IMPORT_C voidWriteInternalStateL(RWriteStream &aWriteStream)const [protected, virtual]

From CCoeControl.

Writes the internal state of the control and its components to a stream. This function is empty in release builds. It is intended to be overridden and base called by subclasses.

Since
App-Framework_6.1
Writes the internal state of the control and its components to aStream. Does nothing in release mode. Designed to be overidden and base called by subclasses.

Parameters

RWriteStream & aWriteStreamThe internal state of the control and its components.

Member Data Documentation

CFbsBitmap * iBackgroundBitmap

CFbsBitmap *iBackgroundBitmap[private]

CFbsBitmap * iBitmap

CFbsBitmap *iBitmap[private]

CFbsBitmap * iBitmapMask

CFbsBitmap *iBitmapMask[private]

TInt iCurrentValue

TInt iCurrentValue[private]

CEikProgressInfoExtension * iExtension

CEikProgressInfoExtension *iExtension[private]

TBool iHeightWasSupplied

TBool iHeightWasSupplied[private]

SInfo iInfo

SInfo iInfo[private]

SLayout iLayout

SLayout iLayout[private]