syncfusion-winforms-clock

Syncfusion WinForms Clock コントロールの実装

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 を設定する