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
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;
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;
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.