简介

KryptonTrackBar 是增强型滑动条控件,替代标准 System.Windows.Forms.TrackBar。它自动跟随 Krypton 主题渲染,支持水平和垂直方向、自定义刻度频率、滑块大小调整,以及丰富的状态外观自定义(Normal / Tracking / Pressed / Disabled)。

KryptonTrackBar 示例截图
KryptonTrackBar 在不同主题下的外观

常用属性

属性类型说明
Valueint当前滑块位置值
Minimumint滑动条最小值
Maximumint滑动条最大值
SmallChangeint方向键单次步进值
LargeChangeint点击轨道或 PageUp/Down 的步进值
TickFrequencyint刻度线间隔(0 表示不显示刻度)
OrientationOrientation方向:Horizontal 或 Vertical
TickStyleTickStyle刻度位置(TopLeft / BottomRight / Both / None)
TrackSizeSize轨道的宽度和高度
StateCommon.Track.Color1Color轨道背景色
StateCommon.Position.Color1Color滑块颜色
StateTracking.Position.Color1Color鼠标悬停时滑块颜色

快速上手

基本用法

using Krypton.Toolkit;

// 创建滑动条
var trackBar = new KryptonTrackBar();
trackBar.Minimum = 0;
trackBar.Maximum = 100;
trackBar.Value = 50;
trackBar.TickFrequency = 10;
trackBar.Location = new Point(20, 20);
trackBar.Size = new Size(300, 45);

// 值变化事件
trackBar.ValueChanged += (s, e) =>
{
    lblValue.Text = $"当前值:{trackBar.Value}";
};

this.Controls.Add(trackBar);

垂直方向滑动条

var vTrackBar = new KryptonTrackBar();
vTrackBar.Orientation = Orientation.Vertical;
vTrackBar.Minimum = 0;
vTrackBar.Maximum = 255;
vTrackBar.Value = 128;
vTrackBar.TickFrequency = 25;
vTrackBar.Size = new Size(45, 200);
vTrackBar.Location = new Point(350, 20);

this.Controls.Add(vTrackBar);

进阶用法

音量控制器(带实时反馈)

// 模拟音量调节
var volumeBar = new KryptonTrackBar();
volumeBar.Minimum = 0;
volumeBar.Maximum = 100;
volumeBar.Value = 70;
volumeBar.SmallChange = 1;
volumeBar.LargeChange = 10;
volumeBar.TickFrequency = 5;
volumeBar.TickStyle = TickStyle.BottomRight;

volumeBar.ValueChanged += (s, e) =>
{
    // 更新音量图标和进度标签
    lblVolume.Text = $"🔊 {volumeBar.Value}%";
    progressBar.Value = volumeBar.Value;
};

this.Controls.Add(volumeBar);

自定义滑块外观

// 自定义轨道和滑块颜色
trackBar.StateCommon.Track.Color1 = Color.FromArgb(230, 230, 230);
trackBar.StateCommon.Track.Color2 = Color.FromArgb(200, 200, 200);
trackBar.StateCommon.Position.Color1 = Color.FromArgb(15, 118, 110);  // 翡翠绿
trackBar.StateCommon.Position.Color2 = Color.FromArgb(13, 148, 136);

// 悬停时高亮
trackBar.StateTracking.Position.Color1 = Color.FromArgb(20, 184, 166);
trackBar.StateTracking.Position.Color2 = Color.FromArgb(45, 212, 191);

// 按下时加深
trackBar.StatePressed.Position.Color1 = Color.FromArgb(17, 94, 89);
提示:在 LCode 设计器中,从工具箱「LCode Components」分类拖放 KryptonTrackBar 即可。属性面板中可设置 Orientation 切换水平/垂直方向。

对应示例项目

📁 Source/Krypton Toolkit Examples/KryptonTrackBar Examples/

包含:水平/垂直滑动条、刻度样式对比、自定义外观演示。

相关控件