Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Using Clock API

From Wiki
Jump to: navigation, search
Article Metadata
Created: vvsnaresh (09 Apr 2007)
Last edited: hamishwillee (30 May 2013)



The Clock APIs in Symbian provides the graphical display of digital and analogue clocks.The clocks are animated to change with system time. The Clock API has three important concepts:

  • clock base classes
  • analogue clock
  • digital clock.

Clock base classes

A number of base classes provide shared functionality for the clocks, including basic display control and time setting. They derive ultimately from RAnim, and are, in inheritance order, RAnimWithUtils, RTimeDevice and RClock. Basically, the animation of the clocks is performed by an animation DLL that plugs-in to the Window Server. The key classes in this API are client-side animation classes, derived from the animation client-side class RAnim.

class RClock : public RTimeDevice;

Analogue clock

These are derived from RClock, the class RAnalogClock provides an analogue clock with configurable colour, size, position, and number of hands. How a hand is drawn is specified by a TAnalogDisplayHand object. The settings for displaying an AM/PM indicator is provided by SAnalogDisplayAmPm.

class RAnalogClock : public RClock;

Digital clock

These are derived from RClock, the class RDigitalClock provides a digital clock with configurable colour, size, position, and font. What time information is displayed is configured through one or more TDigitalDisplayTextSection objects.

class RDigitalClock : public RClock;

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


This page was last modified on 30 May 2013, at 04:41.
39 page views in the last 30 days.