Clock Overview

Provides the graphical display of digital and analogue clocks. The clocks are animated to change with system time.

Architectural relationships

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.

Description

The API has three key concepts: clock base classes, analogue clock, and 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.

Analogue clock

Derived from RClock, the class RAnalogClock provides an analogue clock with configurable color, 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.

Digital clock

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