Class RDigitalClock

class RDigitalClock : public RClock;

Description

A digital clock.

A digital clock is composed of one or more text sections, which define how the time information is displayed.

Derivation

• RAnim - Client-side handle to a server-side animation class.

• RAnimWithUtils - Utility class to support clock animation.

• RTimeDevice - Sets display parameters for clocks.

• RClock - Sets the time for clocks.

• RDigitalClock - A digital clock.

Members

Defined in RDigitalClock:

• AddTextSectionL(const TDigitalDisplayTextSection &)Adds a text section to the clock.
• ConstructL(TTimeIntervalSeconds,const TPoint &,const TSize &,const TMargins &,const STimeDeviceShadow &,TRgb,TInt)Completes construction of a digital clock.
• RDigitalClock(RAnimDll &,const RWindowBase &)Creates a digital clock object.
• SetBackgroundColor(TRgb,TRgb)Sets the background colour for the clock.
• SetTextColor(TRgb)Sets the text colour.

Inherited from RAnim:

• AsyncCommandReply(TRequestStatus &,TInt,const TIpcArgs &)Sends a command and its arguments to the server-side CAnim instance asynchronous...
• Command(TInt)Sends a command to the server-side CAnim instance, and returns immediately.
• Command(TInt,const TPtrC8 &)Sends a command and its arguments to the server-side CAnim instance, and returns...
• CommandReply(TInt)Sends a command to the server-side CAnim instance, and waits for a response.
• CommandReply(TInt,const TDesC8 &,const TIpcArgs &)Sends a command and its arguments to the server-side CAnim instance, and waits f...
• CommandReply(TInt,const TPtrC8 &)Sends a command and its arguments to the server-side CAnim instance, and waits f...
• Construct(const RWindowBase &,TInt,const TDesC8 &)Completes construction of the object based on a window device, and creates the s...
• Construct(const RWindowBase &,TInt,const TDesC8 &,const TIpcArgs &)Completes construction of the object based on a window device, and creates the s...
• Construct(const RWsSprite &,TInt,const TDesC8 &)Completes construction of the Anim DLL based on a sprite.
• Construct(const RWsSprite &,TInt,const TDesC8 &,const TIpcArgs &)Completes construction of the Anim DLL based on a sprite.
• Destroy()Closes and deletes the server-side animation object.
• RAnim(RAnimDll &)Protected C++ constructor.

Inherited from RAnimWithUtils:

• Close()Closes the clock animation.

Inherited from RClock:

• SetUniversalTimeOffset(TTimeIntervalSeconds)Adjusts the clock's time.

Inherited from RTimeDevice:

• Draw()Draws the clock.
• SetPosition(const TPoint &)Sets the clock's on-screen position.
• SetPositionAndSize(const TPoint &,const TSize &)Sets the clock's on-screen position and size.
• SetSize(const TSize &)Sets the clock's on-screen size.
• SetVisible(TBool)Makes the clock visible. By default, clocks are invisible.
• UpdateDisplay()Forces an update to the clock's display.

IMPORT_C RDigitalClock(RAnimDll &aAnimDll, const RWindowBase &aWindow);

Description

Creates a digital clock object.

To complete construction, you must call RDigitalClock::ConstructL(TTimeIntervalSeconds,const TPoint &,const TSize &,const TMargins &,const STimeDeviceShadow &,TRgb,TInt).

Parameters

RAnimDll &aAnimDll This RAnimDll must have been loaded with the server-side clock animation DLL, clocka.dll const RWindowBase &aWindow Window to which to add the clock

IMPORT_C void ConstructL(TTimeIntervalSeconds aUniversalTimeOffset, const TPoint &aPosition, const TSize &aSize, const TMargins &aMargins, const STimeDeviceShadow &aShadow, TRgb aBackgroundColor, TInt aNumTextSections);

Description

Completes construction of a digital clock.

Parameters

TTimeIntervalSeconds aUniversalTimeOffset Initial time for the clock, expressed as an offset from universal time const TPoint &aPosition Clock's on-screen position const TSize &aSize Clock's on-screen size const TMargins &aMargins Margin settings const STimeDeviceShadow &aShadow Shadow settings TRgb aBackgroundColor Background color TInt aNumTextSections Number of text sections

IMPORT_C void AddTextSectionL(const TDigitalDisplayTextSection &aTextSection);

Description

Adds a text section to the clock.

This function can only be called after full construction of the clock.

Parameters

const TDigitalDisplayTextSection &aTextSection Describes text section to add

IMPORT_C void SetBackgroundColor(TRgb aBackgroundColor, TRgb aShadowColor);

Description

Sets the background colour for the clock.

This function can only be called after full construction of the clock.

Parameters

TRgb aBackgroundColor Background colour TRgb aShadowColor Shadow colour

IMPORT_C void SetTextColor(TRgb aTextColor);

Description

Sets the text colour.

This function can only be called after full construction of the clock.

Parameters

TRgb aTextColor Text colour