syncfusion-winforms-clock

实现 Syncfusion WinForms 时钟控件

Syncfusion Clock 控件（Syncfusion.Windows.Forms.Tools.Clock）是仅用于显示的控件，可将当前时间显示为模拟时钟或数字时钟。它支持广泛的视觉自定义，包括指针颜色和粗细、渐变背景、数字模式下的边框和形状、透明度，以及可完全替换的渲染管线。

何时使用此技能

在以下情况下使用此技能：

• 向 WinForms 窗体添加时钟显示（模拟或数字）
• 通过 ClockType 在模拟和数字模式之间切换
• 自定义颜色——渐变背景、指针颜色、边框、分钟刻度线
• 配置数字时钟边框或形状——ClockFrame、ClockShape
• 显示固定时间或自定义时间——ShowCustomTimeClock + CustomTime
• 将时钟冻结在特定时间——StopTimer
• 应用自定义渲染器——重写 ClockRenderer.DrawInterior 或 DigitalClockRenderer.DrawDigitalClockFrame

组件概览

属性	类型	说明
ClockType	ClockTypes	Analog 或 Digital
ShowCustomTimeClock	bool	启用自定义（非系统）时间显示
CustomTime	DateTime	当 ShowCustomTimeClock 为 true 时显示的自定义时间
StopTimer	bool	将时钟冻结在当前时间
IsTransparent	bool	透明背景（模拟时钟）
Renderer	ClockRenderer	用于模拟时钟指针的自定义渲染器
DigitalRenderer	DigitalClockRenderer	用于数字时钟边框的自定义渲染器

文档与导航指南

入门

📄 阅读： references/getting-started.md

• 程序集引用和 NuGet 包设置
• 通过设计器或编程方式添加 Clock
• 在模拟和数字模式之间切换（ClockType）
• 显示固定时间或自定义时间（ShowCustomTimeClock、CustomTime）
• 冻结时钟（StopTimer）

外观与颜色自定义

📄 阅读： references/appearance-and-color.md

• 渐变背景颜色（StartGradientBackColor、EndGradientBackColor）
• 指针颜色（HourHandColor、MinuteHandColor、SecondHandColor）
• 分钟刻度线和边框颜色（MinuteColor、BorderColor）
• 指针粗细（HourHandThickness、MinuteHandThickness、SecondHandThickness、MinuteThickness）
• 显示/隐藏开关（ShowAMorPM、ShowBorder、ShowMinute、ShowSecondHand）
• 透明背景（IsTransparent）

数字时钟

📄 阅读： references/digital-clock.md

• 启用数字模式
• 边框与形状——两者互斥；使用 ShowClockFrame 进行切换
• ClockFrame 的值：RectangularFrame、CircularFrame、SquareFrame
• ClockShape 的值：Rectangle、RoundedRectangle、Circle、Square、RoundedSquare
• 颜色自定义：ForeColor、BackgroundColor、BorderColor
• 行为：DisplayDates、ShowHourDesignator
• 数字模式下的自定义时间
• 自定义数字时钟边框渲染器（DigitalRenderer）

自定义渲染器（模拟时钟）

📄 阅读： references/custom-renderer.md

• 派生 ClockRenderer 并重写 DrawInterior
• sender 的值："SecondsHand"、"MinutesHand"、"HoursHand"、分钟刻度线（else）
• 使用 LineCap、DashStyle 自定义画笔
• 将渲染器分配给时钟

快速入门

C# — 模拟时钟，编程方式：

using Syncfusion.Windows.Forms.Tools;

Clock clock1 = new Clock();
clock1.ClockType = ClockTypes.Analog;
clock1.StartGradientBackColor = Color.Black;
clock1.HourHandColor = Color.SkyBlue;
clock1.MinuteHandColor = Color.LightSeaGreen;
clock1.SecondHandColor = Color.LightSteelBlue;
this.Controls.Add(clock1);

VB.NET — 数字时钟：

Imports Syncfusion.Windows.Forms.Tools

Dim clock1 As New Clock()
clock1.ClockType = ClockTypes.Digital
clock1.ShowClockFrame = True
clock1.ClockFrame = ClockFrames.RectangularFrame
Me.Controls.Add(clock1)

常见用例

场景	要设置的属性
显示实时模拟时钟	ClockType = Analog（默认值）
显示带边框的数字时钟	ClockType = Digital、ShowClockFrame = true、ClockFrame = ...
停在特定时间	StopTimer = true
显示自定义／固定时间	ShowCustomTimeClock = true、CustomTime = new DateTime(...)
透明模拟时钟叠加层	IsTransparent = true
自定义指针渲染	派生 ClockRenderer，设置 clock1.Renderer
自定义数字时钟边框	派生 DigitalClockRenderer，设置 clock1.DigitalRenderer