Siticone Circular Timer

The SiticoneCircularTimerControl is a powerful, all-in-one radial timing solution. It functions as a Countdown, Stopwatch, or Pomodoro timer with built-in logic for managing states (Running, Paused, Overtime), visual alerts, and color transitions.

Time & Duration

Core properties to control the timer's logic.

Property	Type	Description & Usage Example
`Time`	TimeSpan	timer.Time = TimeSpan.FromMinutes(5); Current time displayed. For countdowns, this decreases; for stopwatches, it increases.
`TotalDuration`	TimeSpan	timer.TotalDuration = TimeSpan.FromMinutes(25); The target or starting duration. Determines progress percentage (0-100%).
`TimerType`	TimerType	timer.TimerType = TimerType.Countdown; Logic mode. Options: `Countdown`, `Stopwatch`, `Pomodoro`, `Kitchen`.
`AllowOvertime`	bool	timer.AllowOvertime = true; If true, the timer continues counting (into negatives or upwards) after reaching 0/Duration.

Visual Style

Colors used for different timer states.

Property	Type	Description & Usage Example
`DesignStyle`	DesignStyle	timer.DesignStyle = TimerControlDesignStyle.RainBow; `Solid`: Color changes by state. `RainBow`: Gradient based on progress. `Animated`: Cycling colors.
`RunningColor`	Color	timer.RunningColor = Color.Green; Color used while the timer is active.
`PausedColor`	Color	timer.PausedColor = Color.Orange; Color used when paused.
`WarningColor`	Color	timer.WarningColor = Color.Yellow; Color used when below warning threshold.
`OvertimeColor`	Color	timer.OvertimeColor = Color.Red; Color used when time expires (if overtime allowed).

Text & Formatting

Options for the digital readout.

Property	Type	Description & Usage Example
`TimeDisplayFormat`	Format	timer.TimeDisplayFormat = TimeDisplayFormat.MinutesSeconds; `MinutesSeconds` (05:00), `HoursMinutesSeconds`, `SecondsOnly`.
`ShowTime`	bool	timer.ShowTime = true; Shows/hides digital time.
`ShowTimerLabel`	bool	timer.ShowTimerLabel = true; Shows status text below time (e.g., "Running", "Paused").

Timer Logic

Configuration for alerts and thresholds.

Property	Type	Description & Usage Example
`WarningThreshold`	TimeSpan	timer.WarningThreshold = TimeSpan.FromSeconds(10); Time remaining when warning state activates.
`EnableTimerAlerts`	bool	timer.EnableTimerAlerts = true; Triggers events on warning/completion.

Public Methods

Start()

// Begins or resumes the timer.
timer.Start();

Pause()

// Pauses the timer.
timer.Pause();

Stop() / Reset()

// Stops timer and resets to initial state.
timer.Stop();

SetTimer(TimeSpan, TimerType)

// Configures a new session.
timer.SetTimer(TimeSpan.FromMinutes(25), TimerType.Pomodoro);

AddTime(TimeSpan)

// Adds extra time to running countdown.
timer.AddTime(TimeSpan.FromMinutes(1));

Events

Events Wiring

// 1. TimeChanged Event
// Fires every tick (100ms).
timer.TimeChanged += (s, e) => 
{
                // Update external UI if needed
};

// 2. TimerCompleted Event
// Fires when time reaches zero (or duration).
timer.TimerCompleted += (s, e) => 
{
                MessageBox.Show("Time's up!");
                PlaySound();
};

// 3. TimerWarning Event
// Fires when entering warning zone.
timer.TimerWarning += (s, e) => 
{
    lblStatus.Text = e.WarningMessage;
    lblStatus.ForeColor = Color.Red;
};

Designer & Smart Tags

Quickly configure timer logic in Visual Studio.

Feature	Description
`Timer Presets`	Pomodoro: 25min work timer. Kitchen: 10min simple timer. Stopwatch: Count-up mode. Workout: High-visibility seconds timer.
`Quick Durations`	One-click duration setup: 30s, 1m, 5m, 10m, 30m, 1h.

Detailed Usage Examples

Example 1: Pomodoro App

A classic productivity timer with work/break cycles.

C# - Pomodoro

private void StartWorkSession()
{
                // 25 Minute Focus
    timer.SetTimer(TimeSpan.FromMinutes(25), TimerType.Pomodoro);
    timer.DesignStyle = TimerControlDesignStyle.Solid;
    timer.RunningColor = Color.Tomato;
    timer.Start();
    
    timer.TimerCompleted += (s, e) => StartBreakSession();
}

private void StartBreakSession()
{
                // 5 Minute Break
    timer.SetTimer(TimeSpan.FromMinutes(5), TimerType.Break);
    timer.RunningColor = Color.LightGreen;
    timer.Start();
}

Example 2: Workout Stopwatch

A count-up timer for tracking exercise duration.

C# - Stopwatch

private void SetupStopwatch()
{
    timer.TimerType = TimerType.Stopwatch;
    timer.TotalDuration = TimeSpan.Zero; // Open ended or set a goal
    timer.TimeDisplayFormat = TimeDisplayFormat.SecondsOnly;
    
                // Style
    timer.DesignStyle = TimerControlDesignStyle.RainBow;
    timer.ProgressThickness = 20;
}

private void BtnLap_Click(object sender, EventArgs e)
{
                Console.WriteLine($"Lap: {timer.ElapsedTime}");
}