Class CEikClock

class CEikClock : public CEikBorderedControl, public MEikClockContainer;

Description

Clock control.

An on-screen clock that can be initialised from a CLOCK resource struct, and can be switched between analog and digital display with a pointer tap. CEikClock is implemented as a container control wrapped around a more primitive CEikLocaleConformantClock .

The clock control has an associated resource struct CLOCK and control factory identifier EEikCtClock .

This class is not intended for user derivation.

Derivation

• MEikClockContainer - Base class used in the derivation of CEikClock
• MEikBorderedControl - Interface for bordered controls

• CCoeControl - Control base class from which all other controls are derived
• CEikBorderedControl - A control which is drawn surrounded by a rectangular border
• CEikClock - Clock control

Members

Defined in CEikClock:
ActivateL(), CEikClock(), ClockIsVisible(), ConstructClockL(), ConstructFromResourceL(), Draw(), GetClockPositionAndSize(), GetColorUseListL(), HandlePointerEventL(), HandleResourceChange(), HasBorder(), MakeVisible(), MinimumSize(), PositionChanged(), SetClock(), SizeChanged(), ~CEikClock()

Inherited from CBase:
Delete(), Extension_(), operator new()

Inherited from CCoeControl:
AccumulatedZoom(), ActivateGc(), BackedUpWindow(), Background(), CapturesPointer(), ClaimPointerGrab(), CloseWindow(), ComponentArrayExists(), Components(), ControlContext(), ControlEnv(), CopyControlContextFrom(), CreateBackedUpWindowL(), CreateWindowL(), DeactivateGc(), DrawBackground(), DrawDeferred(), DrawForeground(), DrawNow(), DrawableWindow(), EAbsoluteZoom, ERelativeZoom, EnableDragEvents(), FindBackground(), FindFontProvider(), GetColor(), GetGc(), GetTextDrawer(), GrabbingComponent(), HandleComponentControlsResourceChange(), HandleRedrawEvent(), HitTest(), IgnoreEventsUntilNextPointerUp(), Index(), InitComponentArrayL(), IsActivated(), IsBackedUp(), IsBeingDestroyed(), IsBlank(), IsDimmed(), IsFocused(), IsNonFocusing(), IsReadyToDraw(), IsVisible(), LayoutManager(), MaximumWidth(), MopNext(), Observer(), OverrideColorL(), OwnsWindow(), Parent(), Position(), PositionRelativeToScreen(), Rect(), RecursivelyMergedInputCapabilities(), ReportEventL(), Reserved_2(), ResetGc(), ScreenFont(), SetAllowStrayPointers(), SetBackground(), SetBlank(), SetCanDrawOutsideRect(), SetComponentsToInheritVisibility(), SetControlContext(), SetCornerAndSize(), SetExtent(), SetExtentToWholeScreen(), SetFocus(), SetFocusing(), SetFontProviderL(), SetGc(), SetGloballyCapturing(), SetHitTest(), SetMaximumWidth(), SetMopParent(), SetNonFocusing(), SetObserver(), SetPointerCapture(), SetPosition(), SetRect(), SetSize(), SetSizeWithoutNotification(), SetUniqueHandle(), SetZoomFactorL(), Size(), SystemGc(), TZoomType, TextDrawer(), UniqueHandle(), Window(), ZoomWithType(), iCoeEnv, iContext, iPosition, iSize

Inherited from CEikBorderedControl:
Border(), ComponentControl(), CountComponentControls(), FocusChanged(), GetHelpContext(), HandleControlArrayEventL(), HandlePointerBufferReadyL(), InputCapabilities(), MopSupplyObject(), OfferKeyEventL(), PrepareForFocusGainL(), PrepareForFocusLossL(), RequestRelayout(), SetAdjacent(), SetBorder(), SetContainerWindowL(), SetDimmed(), SetLayoutManagerL(), SetNeighbor(), SetParent(), SetTextBaselineSpacing(), TextBaselineOffset(), WriteInternalStateL(), iBorder

Inherited from MEikBorderedControl:
ETypeId, anonymous

Inherited from MObjectProvider:
MObjectProvider_Reserved1(), MObjectProvider_Reserved2(), MopGetObject(), MopGetObjectNoChaining()

IMPORT_C CEikClock();

Description

First phase constructor.

Complete construction with either ConstructFromResourceL() or SetClock() .

virtual IMPORT_C ~CEikClock();

Description

Destructor. This function frees all resources owned by this object.

IMPORT_C void SetClock(CEikLocaleConformantClock *aClock);

Description

Completes construction, setting the primitive clock control owned by this CEikClock . Application developers need only call this function if the clock is not constructed from a resource.

CEikClock takes full ownership of aClock , and will delete it upon destruction.

Parameters

Panic codes

virtual IMPORT_C void HandlePointerEventL(const TPointerEvent &aPointerEvent);

Description

Handles pointer events.

CEikClock 's response to a pointer tap is to switch between digital and analog clocks if both are available.

Parameters

See also:

• CCoeControl::HandlePointerEventL()

virtual IMPORT_C void MakeVisible(TBool aVisible);

Description

Makes the control visible or invisible. See CCoeControl::MakeVisible() .

Parameters

See also:

• CCoeControl::MakeVisible()

virtual IMPORT_C void ConstructFromResourceL(TResourceReader &aResourceReader);

Description

Completes construction from resource.

The clock's fields are initialised to the values read by aResourceReader from a CLOCK resource. See CCoeControl::ConstructFromResourceL() .

This function creates a CEikResourceConstructedClock , which is a type of CEikLocaleConformantClock .

Parameters

See also:

• CCoeControl::ConstructFromResourceL()

virtual IMPORT_C void ActivateL();

Description

Sets the control as ready to be drawn.

Sets the background colour to the standard control colour.

See also:

• CCoeControl::ActivateL()

virtual IMPORT_C TSize MinimumSize();

Description

Gets the minimum size of the control.

Return value

See also:

• CCoeControl::MinimumSize()

virtual IMPORT_C TBool HasBorder() const;

Description

Tests whether the control has a border.

Return value

See also:

• CCoeControl::HasBorder()

virtual IMPORT_C void GetColorUseListL(CArrayFix< TCoeColorUse > &aColorUseList) const;

Description

Gets the list of logical colours used to draw the control. The list includes an explanation of how each colour is used, and is appended to aColorUseList .

Parameters

virtual IMPORT_C void HandleResourceChange(TInt aType);

Description

Handles a change to the control's resources.

The types of resources handled are those that are shared across the environment, e.g. colours or fonts.

Parameters

See also:

• CCoeControl::HandleResourceChange()

private: virtual IMPORT_C void SizeChanged();

Description

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

See also:

• CCoeControl::SizeChanged()

private: virtual IMPORT_C void PositionChanged();

Description

Sets the position of the clock.

See also:

• CCoeControl::PositionChanged()

private: virtual IMPORT_C void Draw(const TRect &aRect) const;

Description

Sets the color of the clock and calls CEikConformatClock::Draw() method.

Parameters

private: virtual IMPORT_C TBool ClockIsVisible(const CEikLocaleConformantClock &aClock) const;

Description

Used to see if the clock is visible on the screen.

Parameters

Return value

private: virtual IMPORT_C void GetClockPositionAndSize(TPoint &aPosition, TSize &aSize, const CEikLocaleConformantClock &aClock, const TSize &aMinimumSize);

Description

Gets the position and size of the clock.

Parameters

private: virtual IMPORT_C void ConstructClockL(CEikLocaleConformantClock &aClock);

Description

Override this if you want to call the CEikLocaleConformantClock::ConstructL with parameters.

Parameters