Siticone HSlider

The SiticoneHSlider is a high-performance, customizable horizontal slider control. It is designed for modern user interfaces, offering smooth value interpolation animations, advanced thumb effects (like pulsing and glowing), and comprehensive support for mouse and keyboard interaction.

Range & Values

Configure the fundamental numeric range and current position of the slider thumb.

Property	Type	Description & Usage Example
`Minimum`	int	slider.Minimum = 0; The start value of the slider range.
`Maximum`	int	slider.Maximum = 100; The end value of the slider range.
`Value`	int	slider.Value = 50; The current position of the thumb within the range.
`Step`	int	slider.Step = 5; The increment value when using arrow keys or mouse wheel.

Appearance & Styling

Customize every visual aspect of the slider, from colors to thumb size and styles.

Property	Type	Description & Usage Example
`TrackColor`	Color	slider.TrackColor = Color.LightGray; The background color of the unfilled track.
`ElapsedTrackColor`	Color	slider.ElapsedTrackColor = Color.DodgerBlue; The color of the track portion from Minimum to the current Value.
`ThumbColor`	Color	slider.ThumbColor = Color.White; The main fill color of the thumb handle.
`ThumbBorderColor`	Color	slider.ThumbBorderColor = Color.Blue; The border color of the thumb.
`ThumbHoverColor`	Color	slider.ThumbHoverColor = Color.AliceBlue; The thumb color when the mouse is hovering over it.
`ThumbSize`	int	slider.ThumbSize = 20; The diameter/size of the thumb in pixels.
`TrackHeight`	int	slider.TrackHeight = 4; The thickness of the slider track line.

Animation & Effects

Configure visual feedback animations such as glow, pulse, and smooth value transitions.

Property	Type	Description & Usage Example
`ThumbType`	ThumbType	slider.ThumbType = ThumbType.Glow; Sets the visual style: `Solid`, `Blink`, `Gradient`, `Pulsate`, or `Glow`.
`HoverEffects`	bool	slider.HoverEffects = true; Enables hover animations like size expansion or color change.
`ShowValueToolTipOnHover`	bool	slider.ShowValueToolTipOnHover = true; Displays a tooltip with the current value when hovering over the control.
`UltraFastMode`	bool	slider.UltraFastMode = true; Disables animations for maximum performance in resource-constrained scenarios.

Interaction & Behavior

Settings that define how the user interacts with the control, including read-only mode and feedback.

Property	Type	Description & Usage Example
`IsReadOnly`	bool	slider.IsReadOnly = true; If true, value changes are disabled. The control updates its visual style to indicate this state.
`MouseWheelEnabled`	bool	slider.MouseWheelEnabled = true; Allows changing the value by scrolling the mouse wheel.
`KeyboardEnabled`	bool	slider.KeyboardEnabled = true; Allows changing the value using Arrow keys (small change) and Page keys (large change).
`CanShake`	bool	slider.CanShake = true; If true, the control shakes visually when an invalid interaction occurs (e.g., clicking while ReadOnly).

Designer & Smart Tags

The control includes a rich Smart Tag panel for rapid configuration directly in the Visual Studio designer.

Feature	Description
`Theme Presets`	Instantly apply color schemes like "Midnight Plum", "Ocean Blue", "Forest Green", and "Sunset Orange" via the designer menu.
`Quick Actions`	Shortcuts to set common ranges (0-100, -100 to 100), reset defaults, and toggle read-only mode.
`Animation Tests`	Run test animations (Animate to Min/Max, Sweep) directly in the designer to preview behavior.

Detailed Usage Examples

Example 1: Volume Control

A classic volume slider (0-100) with a custom appearance.

C# - Volume Slider

private void SetupVolumeSlider()
{
    var volSlider = new SiticoneHSlider();
    volSlider.Minimum = 0;
    volSlider.Maximum = 100;
    volSlider.Value = 50;
    
                // Visuals
    volSlider.ElapsedTrackColor = Color.LimeGreen;
    volSlider.ThumbColor = Color.White;
    volSlider.ThumbType = ThumbType.Glow;
    volSlider.GlowColor = Color.LightGreen;
    
                // Tooltip
    volSlider.ShowValueToolTipOnHover = true;
    
                // Event
    volSlider.ValueChanged += (s, e) => 
    {
                Console.WriteLine($"Volume: {volSlider.Value}%");
                SetSystemVolume(volSlider.Value);
    };
    
    this.Controls.Add(volSlider);
}

Example 2: Brightness Adjuster

Using the slider to control screen brightness with custom thumb animation.

C# - Brightness Control

private void InitializeBrightnessControl()
{
    var brightSlider = new SiticoneHSlider();
    brightSlider.Minimum = 10;
    brightSlider.Maximum = 100;
    brightSlider.Value = 75;
    
                // Styling
    brightSlider.TrackColor = Color.Gray;
    brightSlider.ElapsedTrackColor = Color.Yellow;
    brightSlider.ThumbType = ThumbType.Pulsate; // Pulsing effect
    
                // Interaction
    brightSlider.MouseWheelEnabled = true;
    brightSlider.MouseWheelDelta = 5;
    
    this.Controls.Add(brightSlider);
}

Example 3: Read-Only Progress Indicator

Using the slider as a progress bar that users cannot modify directly.

C# - Progress Display

private void UpdateProgress(int percentage)
{
    progressSlider.IsReadOnly = true;
    progressSlider.CanShake = true; // Feedback if user clicks
    
                // Programmatically update value
    progressSlider.Value = percentage;
    
                // Dynamic coloring based on completion
    if (percentage >= 100) 
        progressSlider.ReadOnlyElapsedTrackColor = Color.Green;
    else 
        progressSlider.ReadOnlyElapsedTrackColor = Color.DodgerBlue;
}