New to Telerik UI for WinForms? Start a free 30-day trial

RadClock

Class

Represents a clock control that displays time with customizable appearance and functionality. The control can show system time or a specific time value with optional offset support.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

public class RadClock : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadClock...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISynchronizeInvokeIWin32Window...

Constructors

RadClock()

Initializes a new instance of the RadClock class with default settings. The control is configured with auto-sizing enabled and fixed dimensions.

public RadClock()

Gets or sets a value indicating whether the control's size will be determined automatically based on the current font. When enabled, the control automatically adjusts its dimensions to accommodate the font size.

[Browsable(false)]
public override bool AutoSize { get; set; }

Overrides: RadControl.AutoSize

ClockElement

RadClockElement

Gets the RadClockElement that encapsulates the UI representation and core functionality of the clock control.

[Browsable(false)]
public RadClockElement ClockElement { get; }

DefaultSize

Size

Gets the default size of the clock control.

protected override Size DefaultSize { get; }

Overrides: Control.DefaultSize

Offset

TimeSpan

Gets or sets the time offset to apply to the displayed time. This offset is added to the system time when ShowSystemTime is true.

public TimeSpan Offset { get; set; }

RightToLeft

Gets or sets the right-to-left text direction for the control. This property is not fully supported for the clock control.

[Browsable(false)]
public override RightToLeft RightToLeft { get; set; }

Overrides: Control.RightToLeft

ShowSystemTime

bool

Gets or sets a value indicating whether the clock will display the current system time. When set to true, the clock automatically updates to show the current system time.

public bool ShowSystemTime { get; set; }

Value

DateTime?

Gets or sets the current time value displayed by the clock. When set to null, the clock displays the system time if ShowSystemTime is enabled.

[Browsable(true)]
public DateTime? Value { get; set; }

Methods

CreateChildItems(RadElement)

Creates the child elements for the clock control, specifically the RadClockElement.

protected override void CreateChildItems(RadElement parent)

Parameters:parentRadElement

The parent element to which child elements will be added.

Overrides: RadControl.CreateChildItems(RadElement)

InitializeRootElement(RootRadElement)

Initializes the root element of the clock control with specific configuration.

protected override void InitializeRootElement(RootRadElement rootElement)

Parameters:rootElementRootRadElement

The root element to initialize.

Overrides: RadControl.InitializeRootElement(RootRadElement)